Productos
Obtener el listado de productos
GET /productos
Permite obtener el listado de productos:
Listado de parámetros
| Parámetro | ¿Es Obligatorio? | Tipo de Dato | Observaciones |
|---|---|---|---|
| empresa | No | ID |
Este parámetro solo está disponible para cuentas de marketplaces. Permite que un marketplace obtenga el listado de productos de un seller asociado al mismo.
Importante: Solo podrás ver los productos de aquellos sellers que tengan una cuenta activa en tu marketplace. |
| pagina | No | Numero |
Obtener el listado de categorias a las que puede asociarse un producto
GET /productos/categorias
Permite obtener el listado de categorias.
Crear un producto
POST /producto
Crea un nuevo producto en tu cuenta Envíopack.
Listado de parámetros
Los parámetros marcados como "Condicional son aquellos que solo son obligatorios cuando el producto se utilizará con el servicio de Fullpack
| Parámetro | ¿Es Obligatorio? | Tipo de Dato | Observaciones |
|---|---|---|---|
| empresa | No | ID | Este parámetro solo está disponible para cuentas de marketplaces. Permite a un marketplace crear productos para un seller asociado al mismo. Importante: Solo podrás crear productos para aquellos sellers que tengan una cuenta activa en tu marketplace. |
| sku | Sí | String | Máx. 200 caracteres |
| nombre | Sí | String | Máx. 200 caracteres |
| categoria | Condicional | ID | Deberá informarse el valor ID devuelto por el webservice de categorias de productos. |
| codigo_fiscal | Condicional | String | En este campo debera informarse el código ARBA del producto. Máx. 50 caracteres. |
| valor_reposicion | Condicional | Numero | Hasta 2 dígitos decimales. |
| atributos | No | Array | En este campo podes enviar un array JSON con atributos que identifiquen al producto de otra variante similar. Por ejemplo: {"Talle L","Blanco"}. |
| identificadores_alternativos | Condicional | Array | En este campo podes enviar un array JSON con el o los códigos EAN del producto Por ejemplo: {"ABC12345678","ABC12345679"}. |
| paquetes | Sí | Array |
El valor esperado es un array JSON, donde cada posición del array debe contener un objeto JSON formado por:
|
| enviar_solo | Sí | Booleano |
Indica si el producto puede compartir una misma caja con otro producto al momento de despacharse o si debe enviarse solo en su propia caja.
Si no sabes qué dato enviar, te sugerimos pensar en cuál es la caja más grande en la que preparas tus envíos. Si el volumen del producto es mayor al de dicha caja, envía true; en caso contrario, envía false. Si aún tenes dudas, te sugerimos enviar true si el volumen del producto es mayor a 27.000 cm3. Por ejemplo, si las dimensiones de tu producto son 20 x 30 x 20 cm, su volumen es 12.000 cm3, en cuyo caso enviarías false. |
Ejemplo
REQUEST
curl -X POST \
'https://api.enviopack.com/productos?access_token=[TU_ACCESS_TOKEN]' \
--data-binary '
{
"sku": "34003003400",
"nombre": "AIRE ACOND. RCA 3500W FRIO CALOR PORTATIL (AAPR12K)",
"categoria": 5,
"codigo_fiscal": "7322",
"valor_reposicion": 35999
"atributos": [],
"identificadores_alternativos": [
"7796941230172"
],
"paquetes": [
{
"alto": 79,
"ancho": 48,
"largo": 40,
"peso": 32
}
],
"enviar_solo": true
}'Editar un producto
POST /productos/[ID]
Para editar un producto, se debe enviar la misma estructura que se utiliza para crearlo, solo teniendo en cuenta la siguiente salvedad.
En la estructura de un paquete, debes agregar el ID del paquete que se devuelve al crear o solicitar la información de un producto.
Es decir:
...
"paquetes": [
{
"id": 135679,
"alto": 79,
"ancho": 48,
"largo": 40,
"peso": 32
}
],
...Editar un producto por SKU
POST /productos/sku/[SKU]
Para editar un producto, se debe enviar la misma estructura que se utiliza para crearlo, solo teniendo en cuenta la siguiente salvedad.
En la estructura de un paquete, debes agregar el ID del paquete que se devuelve al crear o solicitar la información de un producto.
Es decir:
...
"paquetes": [
{
"id": 135679,
"alto": 79,
"ancho": 48,
"largo": 40,
"peso": 32
}
],
...Cargar la imagen de un producto a partir de su ID
POST /productos/[ID]/cargar-imagen
Carga la imagen de un producto en tu cuenta Envíopack.
Listado de parámetros
| Parámetro | ¿Es Obligatorio? | Tipo de Dato | Observaciones |
|---|---|---|---|
| archivo | Sí | Archivo | Un archivo binario o base64 de una imagen en formato jpg o png (máximo 10MB) |
Ejemplo
REQUEST
curl -X POST \
'https://api.enviopack.com/productos/103000/cargar-imagen?access_token=[TU_ACCESS_TOKEN]' \
--data-binary '
Content-Disposition: form-data; name="archivo"; filename="imagen.jpg" Content-Type: image/jpeg'
Eliminar un producto
Podrás eliminar un producto enviando el id
DELETE /productos?ids=[ID]
| Parámetro | ¿Es Obligatorio? | Tipo de Dato | Observaciones |
|---|---|---|---|
| empresa | No | ID |
Este parámetro permite a las empresas marketplace eliminar productos de sellers asociados. Si no lo envías, se eliminaran los productos asociados a tu propia cuenta.
Importante: Solo podrás eliminar productos de aquellos sellers que tengan cuenta activa en tu marketplace. |