# PIM

Parámetros generales

* ```storeid```. ID de una tienda de plazamundial (requerido)
* ```sku```. Código de un producto (requerido)
* ```id_imagen```. ID de una imagen (requerido para el Método PATCH,DELETE)

## Autenticación

Envíe una clave de API de la tienda (se administran en PlazaMundial) en el encabezado:

```
Authorization: bearer {clave_de_api}
```

Si no puede enviar encabezados, en las consultas se acepta el parámetro `?key={clave_de_api}`. Envíe la clave en todas las operaciones (GET, POST, PATCH y DELETE).

*Sección agregada el 2026-10-19 a partir del código del servicio.* Las respuestas usan la forma `{"success":1,"data":…}`; en caso de error, `{"success":0,"message":"…"}` (`success` llega como número). Mensajes frecuentes: `El Id de tienda no es válido`, `Código de autorización vacío`, `El apikey no existe.`, `SKU no encontrado`.

> **Diferencia con la implementación (2026-10-19):** al agregar una imagen, el campo `id` es opcional: si se omite, el servicio asigna uno nuevo. Solo se procesa el primer archivo del formulario.

## Consultar 
```
Method: GET 
https://pm.api.induxsoft.net/{storeid}/pim/{sku}/images/
```

### Respuesta
```
{
    "success":true,
	"data":[
			{
				"id":"Id de la imagen (requerido)",
				"src":"url de la imagen (requerido)",
				"tags":["etiquetas de la imagen",...],
				"title":"título de la imagen",
				"text":"Texto informativo",
				"width":pixeles,
				"height":pixeles,
				"size":kb_file,
				"variations":[
					{
						"width":pixeles,
						"height":pixeles,
						"size":kb:file,
						"src":"url de esta variación de la imágen"
					},...
				]
			}
		,...]
}
```
En los metadatos también vienen los campos extras guardados para cada imagen

## Agregar una imagen
Agrega una imagen al SKU indicado 

### Solicitud
```

Method: POST
https://pm.api.induxsoft.net/{storeid}/pim/{sku}/images/

Envió de datos por formulario

file:archivo_de_una_imagen (requerido)
id:id de la imagen (requerido)

Datos extra para los metadatos, los datos extras puede ser cualquier campo
Ejemplo:
micampo:campo para metadatos
micampo1:campo1 para metadatos
campo_pim:campo para metadatos
campo_cualquiera:este campo es para metadatos extra

```

### Respuesta

```
{
    "success":true,
	"data":{
				"id":"Id de la imagen (requerido)",
				"src":"url de la imagen (requerido)",
				"tags":["etiquetas de la imagen",...],
				"title":"título de la imagen",
				"text":"Texto informativo",
				"width":pixeles,
				"height":pixeles,
				"size":kb_file,
				"micampo":"campo para metadatos",
				"micampo1":"campo1 para metadatos",
				"campo_pim":"campo para metadatos",
				"campo_cualquiera":"este campo es para metadatos extra",
				"variations":[
					{
						"width":pixeles,
						"height":pixeles,
						"size":kb:file,
						"src":"url de esta variación de la imágen"
					},...
				]
			}
}
```
Los campos extras para el metadatos regresan junto a la respuesta del servicio, si hubiera datos extras.


## Modificar metadatos
Actualiza o agrega los campos indicados en el payload

### Solicitud
```
Method: PATCH
https://pm.api.induxsoft.net/{storeid}/pim/{sku}/images/{id_imagen}

payload
{
  "micampo":"Este campo ha sido actualizado",
  "campo_nuevo":"Este campo ha sido agregado al metadatos"
}
```

### Respuesta

```
{
	"id":"Id de la imagen (requerido)",
	"src":"url de la imagen (requerido)",
	"tags":["etiquetas de la imagen",...],
	"title":"título de la imagen",
	"text":"Texto informativo",
	"width":pixeles,
	"height":pixeles,
	"size":kb_file,
	"micampo":"Este campo ha sido actualizado",
	"campo_nuevo":"Este campo ha sido agregado al metadatos",
	"micampo1":"campo1 para metadatos",
	"campo_pim":"campo para metadatos",
	"campo_cualquiera":"este campo es para metadatos extra",
	"variations":[
		{
			"width":pixeles,
			"height":pixeles,
			"size":kb:file,
			"src":"url de esta variación de la imágen"
		},...
	]
}

```


## Eliminar

Eliminar una imagen, caché y metadatos

### Solicitud
```
Method: DELETE
https://pm.api.induxsoft.net/{storeid}/pim/{sku}/images/{id_imagen}


```

### Respuesta
```
{
    "success":true,
    "data":null
}
```