Introducción

Bienvenido a la API de Centry. Puedes usar nuestra API para acceder a los endpoints, los que entregan variada información sobre los recursos registrados en nuestra base de datos.

Puedes ver los códigos de ejemplo en la región oscura de la derecha y seleccionar el lenguaje de programación que más te acomode en las pestañas que se encuentran en la parte superior.

Para descargar esta documentación y probarla vía postman descárgala en el siguiente link

Aplicaciones y permisos

OAuth 2.0

La API de Centry está basada en estándar de autorización OAuth 2.0 por lo que antes de revisar los endpoints es fundamental tener claros los conceptos detrás de este protocolo. Si no se tiene experiencia previa sobre esta materia, se recomienda revisar los siguientes portales con documentación al respecto:

• OAtuh.net
• OAuth 2.0 Simplified de Aaron Parecki

Entendiendo cómo opera OAuth 2.0 es necesario revisar como se traduce este estándar en términos de Centry:

• Usuario: Es la cuenta de una empresa que otorgará los permisos a la aplicación para que ésta última pueda acceder a la información de productos, pedidos, usuarios, etc.
• Aplicación: Es el registro en Centry del desarrollo que hace uso de la API de Centry. En el siguiente capítulo se explica cómo crear una.
• Tokens: Son las llaves con las que una aplicación puede acceder a la información de la empresa de un usuario.

El estándar OAuth 2.0 ofrece distintos mecanismos por los cuales un usuario puede autorizar a una aplicación. En este capítulo de “Aplicaciones y permisos” se pondrá el foco en el por “código de autorización” (Authorization Code Grant), pero el resto de la documentación opera de la misma manera para otros “Grant Types”.

Con todo lo anterior, el ciclo de una autorización podría resumirse de la siguiente manera:

1. El desarrollador registra una aplicación en Centry. Ver capítulo Crear una Aplicación.
2. Luego se le solicita a todos los usuarios que se quiera acceso a sus datos. Ver capítulo Autorización
   1. Si un usuario autoriza a la aplicación, la plataforma generará un código de autorización y se la entrega a la aplicación.
   2. Con ese código, la aplicación solicita 2 tokens: el access_token y el refresh_token.
3. Con un access_token válido, se puede hacer uso de los endpoint que la API provee.
4. Cuando el access_token caduca, se usa el refresh_token para renovar los tokens. Ver capítulo Renovar los tokens.

Crear una aplicación

Ingresar al panel de aplicaciones externas de Centry y presionar el botón “Nueva Aplicación”.

Se debe rellenar el formulario con los siguientes datos:

Name: mandatory

Nombre que se le quiera dar a la App. Es un campo de texto libre que pretende servir de ayuda al propietario para recordar el uso que le está dando. Ej: “Mi App Android”.

Redirect uri: mandatory

URI a la que se redireccionará cuando se solicite una autorización. En el capítulo Autorización se ve en detalle el uso de esta URI, pero a modo de adelanto, tiene que ser una ruta que sea capaz de leer parámetros que se le envíen vía GET y de ejecutar los pasos necesarios para completar el proceso de autorización. Es en ese sentido que se recomienda habilitar una ruta dedicada a atender esta redirección. Ej: https://www.mi-website.com/centry/auth.

Si se quiere probar localmente o correr en un ambiente en el que no se disponga de una URL fija, puede ingresar urn:ietf:wg:oauth:2.0:oob como redirect URI. Esto va a requerir un par de pasos más por parte del usuario, pero el efecto en el desempeño de la aplicación es exactamente el mismo.

Scopes:

Son los recursos a los que se le solicitará acceso al usuario. En general se distinguen entre permisos de lectura y escritura para pedidos, productos, configuraciones de integraciones, usuarios, Webhooks. Para las pruebas se puede seleccionar cualquiera, pero para una integración de tipo Marketplace Centry sólo acepta que los permisos solicitados sean:

• Pedidos (lectura/escritura)
• Productos (lectura)
• Usuarios (lectura)
• Webhooks (lectura/escritura)

Una vez enviado el formulario, Centry generará un identificador y una clave secreta que serán las llaves necesarias para las futuras conexiones.

Autorización

Hasta el minuto lo único que se tiene es una aplicación creada. Pero para que un cliente pueda usarla, debe solicitar los primeros access_token y refresh_token en base a un código de que genera Centry para cada ocasión. Este proceso se conoce como “Autorización”.

Los pasos a seguir son los siguientes:

1. Ingresar al panel de aplicaciones externas de Centry.
2. Presionar el nombre de la aplicación.
3. Presionar el botón “Autorizar” que está bajo el título “Callback urls”.
4. Confirmar la autorización presionando el botón “Autorizar”.
5. Recuperar el código de actualización.
   • Si la app tiene la URI para hacer pruebas locales, entonces Centry mostrará en pantalla el código de autorización.
   • Si la app está configurada con una URL pública, entonces se redireccionará a la dirección informada en el campo redirect_uri y como un parámetro GET llamado code, se enviará el código de autorización.

Request POST a la URL https://www.centry.cl/oauth/token

curl -X POST https://www.centry.cl/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
        "client_id" : "49fca0b1207097f29a21f12c96a1ce73b361ed354a40d1274d536ab7be4f921e",
        "client_secret" : "73b83c1b7d0257d500e203cb97767c5036c036b71be6b8ed07fa630579b3a3b2",
        "redirect_uri" : "urn:ietf:wg:oauth:2.0:oob",
        "grant_type" : "authorization_code",
        "code" : "770e0c559a2aacee72dd98d573fdeeda3615ef529011c6731fe4592ad327427f"
      }'

Ejemplo de respuesta JSON luego de ejecutar el comando anterior

{
  "access_token":"ae7a9cecd01b346cfb7e6f196b948d8a63cb37f7feae38c4f4a2a31eca27c985",
  "token_type":"bearer",
  "expires_in":7200,
  "refresh_token":"64ab90f5675b0230677a10db46f52f66989e860f534fe92f23329f0e91d76ff5",
  "created_at":1515418927
}

Luego, desde el cliente que hará uso de la API, se completa el proceso de autorización enviando vía POST a la URL https://www.centry.cl/oauth/token los siguientes parámetros:.

Parámetro	Tipo	Descripción
client_id	string	Identificador de la aplicación mandatory
client_secret	string	Llave secreta de la aplicación mandatory
redirect_uri	string	Dirección de redirección mandatory
grant_type	string	Valor fijo igual a authorization_code mandatory
code	string	Código de autorización (authorization_code) mandatory

De la respuesta que entregue la API, es importante registrar el access_token y refresh_token. El primero servirá para firmar todas las solicitudes que se hagan a la API, mientras que el segundo servirá para solicitar un nuevo access_token cuando el actual caduque.

Renovar los tokens

Request POST a la URL https://www.centry.cl/oauth/token

curl -X POST https://www.centry.cl/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
        "client_id" : "49fca0b1207097f29a21f12c96a1ce73b361ed354a40d1274d536ab7be4f921e",
        "client_secret" : "73b83c1b7d0257d500e203cb97767c5036c036b71be6b8ed07fa630579b3a3b2",
        "redirect_uri" : "urn:ietf:wg:oauth:2.0:oob",
        "grant_type" : "refresh_token",
        "refresh_token" : "64ab90f5675b0230677a10db46f52f66989e860f534fe92f23329f0e91d76ff5"
      }'

Ejemplo de respuesta JSON luego de ejecutar el comando anterior

{
  "access_token":"e0b40212ad1f062aafe375ca1a570302940f6e223f164b8aeae108669411c3ef",
  "token_type":"bearer",
  "expires_in":7200,
  "refresh_token":"ea4d55434305f4929ee4dd3080039022912ad14d9fe7751ec7aea233aaca6277",
  "created_at":1515421188
}

El access_token expira cada 7200 segundos (2 horas) por lo que pasado ese periodo cualquier solicitud que se intente hacer con esas credenciales, la API responderá con un error 401.

Lo que se debe hacer es solicitar un nuevo access_token a partir del refresh_token, esto se hace enviando a la URL https://www.centry.cl/oauth/token los siguientes datos vía POST:

Parámetro	Tipo	Descripción
client_id	string	Identificador de la aplicación mandatory
client_secret	string	Llave secreta de la aplicación mandatory
redirect_uri	string	Dirección de redirección mandatory
grant_type	string	Valor fijo igual a refresh_token mandatory
refresh_token	string	Último refresh_token enviado por la API mandatory

De la respuesta que entregue la API, es importante registrar el access_token y refresh_token. El primero servirá para firmar todas las solicitudes que se hagan a la API, mientras que el segundo servirá para solicitar un nuevo access_token cuando el actual caduque.

Products

Parámetros

Atributo	Tipo	Descripción
id	string	Identificador del producto sólo lectura
name	string	Nombre del producto
sku	string	SKU del producto
barcode	string	Código de barras
description	string	Descripción del producto
shortdescription	string	Listado de características del producto del producto. Se recomienda el uso de viñetas HTML sin orden, ie, <ul><li></li></ul>.
condition	string	Describe la condición del producto (Nuevo, usado, renovado)
brand_id	string	Identificador de la marca
category_id	integer	Identificador de categoría a la que pertenece
cover_content_type	string	Extensión de la imagen principal sólo lectura
cover_file_name	string	Nombre de la imagen principal sólo lectura
cover_file_size	integer	Tamaño de la imagen principal sólo lectura
cover_fingerprint	string	CheckSum de la imagen principal sólo lectura
cover_updated_at	date-time	Fecha de actualización de la imagen principal sólo lectura
cover_url	string	URL de la imagen principal.
assets	array	Listado de imágenes secundarias del producto. Ver Atributos de imágenes
deliverytimesupplier	integer	Valor aproximado en días, de la llegada del producto al cliente
gender_id	string	Identificador del genero del producto
is_fullproductname	boolean	Indica si el nombre del producto está completo o acortado
packageheight	integer	Valor en centímetros de la altura del paquete
packagelength	integer	Valor en centímetros del largo del paquete
packageweight	integer	Valor en centímetros del ancho del paquete
packagewidth	integer	Valor en kilogramos del peso del paquete
price_compare	integer	Precio normal
price	integer	Precio de oferta
salestartdate	date-time	Fecha de término de la oferta
saleenddate	date-time	Fecha de inicio del precio de oferta
season	string	Temporada a la que pertenece el producto. Ej “Invierno”
seasonyear	integer	Indica el año del producto
seo_title	string	Meta título del producto. Usado para optimización SEO.
seo_description	string	Meta descripción del producto. Usado para optimización SEO.
status	boolean	Estado del producto. true: Activo; false: Pausado.
variants	array	Lista de variantes del producto. Ver Atributos de variantes
warranty	integer	Descripción de la garantía del producto
company_id	integer	Identificador de la compañía a la que pertenece el producto sólo lectura
created_at	date-time	Fecha de creación del producto en Centry sólo lectura
updated_at	date-time	Fecha de última actualización del producto en Centry sólo lectura
category_attribute_values	array	Valores de atributos de categoría del producto en Centry. Ver Atributos de los valores de atributos de categoria

Atributos de las variantes

Atributo	Tipo	Descripción
_id	string	Identificador de la variante sólo lectura
sku	string	SKU de la variante
barcode	string	Código de barras
product_id	integer	Identificador del producto en Centry sólo lectura
size_id	integer	Identificador de la talla
quantity	integer	Stock de la variante. deprecado
color_id	integer	Identificador del color
company_id	integer	Identificador de la empresa a la que pertenece la variante sólo lectura
created_at	date-time	Fecha en formato UTC de la creación de la variante sólo lectura
updated_at	date-time	Registro de actualización en fecha formato UTC sólo lectura

Atributos de las imágenes

Atributo	Tipo	Descripción
_id	string	Identificador de la imagen. sólo lectura
url	string	URL de la imagen.
image_content_type	string	Es el tipo de contenido de la imagen. Ej: “image/jpeg”. sólo lectura
image_file_name	string	Nombre del archivo de imagen. sólo lectura
image_file_size	integer	Tamaño de la imagen. sólo lectura
image_fingerprint	string	CheckSum de la imagen. sólo lectura
image_updated_at	date-time	Fecha de la última actualización del archivo de imagen. sólo lectura
position	integer	Posición de la imagen en el arreglo de imágenes.
created_at	date-time	Fecha en formato UTC de la creación de la variante sólo lectura
updated_at	date-time	Registro de actualización en fecha formato UTC sólo lectura

Atributos de los valores de atributos de categoría

Atributo	Tipo	Descripción
_id	string	Identificador del valor del atributo de categoría. sólo lectura
category_attribute_id	string	Identificador del atributo de categoría
value_filled	string	Es el valor rellenado para los atributos de tipo texto
value_selected_ids	array	Arreglo de identificadores correspondientes a las opciones seleccionadas para el atributo de tipo selección

Todos los productos de la cuenta

Este endpoint entrega todos los productos de la cuenta.

curl "https://www.centry.cl/conexion/v1/products.json"/
 -H "Authorization: Bearer  <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
  {
    "_id":"597644781d41c846ea000006",
    "barcode":"12345655349384",
    "brand_id":"57f63ffe4c266d1dec1edfb6",
    "category_id":"5769714df82f456e800001aa",
    "color":null,
    "company_id":"597643ab1d41c846ea000001",
    "condition":"new",
    "cover_content_type":null,
    "cover_file_name":null,
    "cover_file_size":null,
    "cover_fingerprint":null,
    "cover_updated_at":null,
    "cover_url":"/images/defaults/products/missing_original.png",
    "created_at":"2017-07-24T19:03:20.245Z",
    "deliverytimesupplier":3,
    "description":"\u003cp\u003eDescripcón detallada del producto donde se explican todos sus atributos y propiedades.\u003c/p\u003e",
    "gender_id":"57ee86e911326899bc8f3f58",
    "id_mercadolibre":null,
    "id_shopify":null,
    "id_woocommerce":null,
    "is_fullproductname":null,
    "listing_type":null,
    "name":"ResTProduct",
    "original_data":null,
    "packageheight":"20",
    "packagelength":"40",
    "packageweight":"1",
    "packagewidth":"20",
    "price":null,
    "price_compare":19999,
    "publish":true,
    "quantity":1000,
    "saleenddate":null,
    "salestartdate":null,
    "season":"Centry 2019",
    "seasonyear":"2015",
    "seo_description":"Meta descripción del producto",
    "seo_title":"Meta título del producto",
    "shortdescription":"\u003cul\u003e\u003cli\u003easdasdasdasd\u003c/li\u003e\u003c/ul\u003e",
    "sku":"CENTSER954",
    "skusupplierconfig":"CENTSER954",
    "status":true,
    "updated_at":"2017-07-24T19:03:20.245Z",
    "variants":[
      {
        "_id":"597649201d41c846ea000009",
        "barcode":"123456553493842",
        "color_id":"57bdc991f82f453f680001d9",
        "created_at":"2017-07-24T19:23:12.919Z",
        "original_data":null,
        "price":null,
        "price_compare":null,
        "product_id":"597644781d41c846ea000006",
        "quantity":9995,
        "size_id":"5851b0c4b2c85e8282262a45",
        "sku":"CENTSER9542",
        "updated_at":"2017-07-24T19:23:12.947Z"
      }
    ],
    "warranty":"2"
  }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/products.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación. Además, de ser necesario algunos filtros pueden ser concatenados de la forma https://www.centry.cl/conexion/v1/products.json?<filter>=<valor>&<filter>=<valor>&…

Obtener un producto específico

Este endpoint entrega un producto en específico.

curl "https://www.centry.cl/conexion/v1/products/597644781d41c846ea000006.json" -H "Authorization: Bearer  <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "_id":"597644781d41c846ea000006",
  "barcode":"12345655349384",
  "brand_id":"57f63ffe4c266d1dec1edfb6",
  "category_id":"5769714df82f456e800001aa",
  "color":null,
  "company_id":"597643ab1d41c846ea000001",
  "condition":"new",
  "cover_content_type":null,
  "cover_file_name":null,
  "cover_file_size":null,
  "cover_fingerprint":null,
  "cover_updated_at":null,
  "cover_url":"/images/defaults/products/missing_original.png",
  "created_at":"2017-07-24T19:03:20.245Z",
  "deliverytimesupplier":3,
  "description":"\u003cp\u003eDescripcón detallada del producto donde se explican todos sus atributos y propiedades.\u003c/p\u003e",
  "gender_id":"57ee86e911326899bc8f3f58",
  "id_mercadolibre":null,
  "id_shopify":null,
  "id_woocommerce":null,
  "is_fullproductname":null,
  "listing_type":null,
  "name":"ResTProduct",
  "original_data":null,
  "packageheight":"20",
  "packagelength":"40",
  "packageweight":"1",
  "packagewidth":"20",
  "price":null,
  "price_compare":19999,
  "publish":true,
  "quantity":1000,
  "saleenddate":null,
  "salestartdate":null,
  "season":"Centry 2019",
  "seasonyear":"2015",
  "seo_description":"Meta descripción del producto",
  "seo_title":"Meta título del producto",
  "shortdescription":"\u003cul\u003e\u003cli\u003eListado de características separadas por viñetas}\u003c/li\u003e\u003c/ul\u003e",
  "sku":"CENTSER954",
  "skusupplierconfig":"CENTSER954",
  "status":true,
  "updated_at":"2017-07-24T19:03:20.245Z",
  "variants":[
    {
      "_id":"597649201d41c846ea000009",
      "barcode":"123456553493842",
      "color_id":"57bdc991f82f453f680001d9",
      "company_id":null,
      "created_at":"2017-07-24T19:23:12.919Z",
      "original_data":null,
      "price":null,
      "price_compare":null,
      "product_id":"597644781d41c846ea000006",
      "quantity":9995,
      "size_id":"5851b0c4b2c85e8282262a45",
      "sku":"CENTSER9542",
      "updated_at":"2017-07-24T19:23:12.947Z"
    }
  ],
  "warranty":"2",
  "category_attribute_values" :[
    {
        "_id": "597649201d41c846ea000129",
        "category_attribute_id": "597649201d41c846ea000021",
        "value_filled": "Valor atributo."
    },
    {
        "_id": "597649201d41c846ea000234",
        "category_attribute_id": "597649201d41c846ea000130",
        "value_selected_ids": [
            "597649201d41c846ea000131",
            "597649201d41c846ea000132"
        ]
    }
  ]
}

HTTP Request

Parámetros URL

Parámetro	Descripción
product_id	El identificador del producto a recuperar

Crear un producto

Este endpoint crea un producto.

curl -X POST https://www.centry.cl/conexion/v1/products.json \
    -H "Authorization: Bearer  <access_token"\
    -H "Content-Type: application/json" \
    -d '{
    "barcode":"123456789",
    "brand_id":"57f63ffe4c266d1dec1edfb6",
    "category_id":"5769714df82f456e800001aa",
    "cover_url": "https://placehold.it/800x1160",
    "deliverytimesupplier":3,
    "description":"Describiendo el asombroso producto que venderás",
    "name":"Un Nombre Fantástico, para un producto fantástico",
    "packageheight":"20",
    "packagelength":"40",
    "packageweight":"1",
    "packagewidth":"20",
    "price":10000,
    "seasonyear":"2015",
    "seo_description":"Descripción",
    "seo_title":"Título asombroso",
    "shortdescription":"\u003cul\u003e\u003cli\u003easdasdasdasd\u003c/li\u003e\u003c/ul\u003e",
    "sku":"YOS0YUN54U",
}'

HTTP Request

Actualizar un producto

Este endpoint actualiza un producto.

curl -X PUT https://www.centry.cl/conexion/v1/products/597644781d41c846ea000006.json \
    -H "Authorization: Bearer  <access_token> "\
    -H "Content-Type: application/json" \
    -d '{
  "price_compare": 19990,
  "seo_title":"Calefactor de pantuflas"
}'

HTTP Request

Parámetros URL

Parámetro	Descripción
product_id	El identificador del producto a actualizar

Eliminar un producto

Este endpoint elimina un producto.

curl -X DELETE https://www.centry.cl/conexion/v1/products/597644781d41c846ea000006.json \
    -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

true

HTTP Request

Parámetros URL

Parámetro	Descripción
product_id	El identificador del producto a eliminar

Contar los productos

Este endpoint entrega la cantidad de productos.

curl -X GET https://www.centry.cl/conexion/v1/products/count.json \
  -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

8

HTTP Request

Todos los historiales de sincronización de un producto

Este endpoint entrega todos los historiales de sincronización de un producto.

curl -X GET https://www.centry.cl/conexion/v1/products/5a16c0bcf82f45273b000054/synchronization_histories.json \
    -H "Authorization: Bearer  <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "603402fe84c6e1418eb6d579",
    "action": "Description update",
    "barcode_messages": {
        "_id": "603402fe84c6e1418eb6d57a",
        "mistakes": [
            "error_barcode_messages_1"
        ],
        "warnings": [
            "warning_barcode_messages_1"
        ]
    },
    "brand_messages": {
        "_id": "603402fe84c6e1418eb6d57b",
        "mistakes": [
            "error_brand_messages_1"
        ],
        "warnings": [
            "warning_brand_messages_1"
        ]
    },
    "category_messages": {
        "_id": "603402fe84c6e1418eb6d57c",
        "mistakes": [
            "error_category_messages_1"
        ],
        "warnings": [
            "warning_category_messages_1"
        ]
    },
    "company_id": "5776daa1f82f454fa8000000",
    "condition_messages": {
        "_id": "603402fe84c6e1418eb6d57d",
        "mistakes": [
            "error_condition_messages_1"
        ],
        "warnings": [
            "warning_condition_messages_1"
        ]
    },
    "created_at": "2021-02-22T16:16:14.393-03:00",
    "deliverytimesupplier_messages": {
        "_id": "603402fe84c6e1418eb6d57e",
        "mistakes": [
            "error_deliverytimesupplier_messages_1"
        ],
        "warnings": [
            "warning_deliverytimesupplier_messages_1"
        ]
    },
    "description_messages": {
        "_id": "603402fe84c6e1418eb6d57f",
        "mistakes": [
            "error_description_messages_1"
        ],
        "warnings": [
            "warning_description_messages_1"
        ]
    },
    "gender_messages": {
        "_id": "603402fe84c6e1418eb6d580",
        "mistakes": [
            "error_gender_messages_1"
        ],
        "warnings": [
            "warning_gender_messages_1"
        ]
    },
    "integration_config_id": "6012c3c784c6e179b53043f5",
    "is_fullproductname_messages": {
        "_id": "603402fe84c6e1418eb6d581",
        "mistakes": [
            "error_is_fullproductname_messages_1"
        ],
        "warnings": [
            "warning_is_fullproductname_messages_1"
        ]
    },
    "is_last": null,
    "marketplace": "centry-test-local-v2",
    "messages": {
        "_id": "603402fe84c6e1418eb6d582",
        "mistakes": [
            "error_messages_1"
        ],
        "warnings": [
            "warning_messages_1"
        ]
    },
    "name_messages": {
        "_id": "603402fe84c6e1418eb6d583",
        "mistakes": [
            "error_name_messages_1"
        ],
        "warnings": [
            "warning_name_messages_1"
        ]
    },
    "packageheight_messages": {
        "_id": "603402fe84c6e1418eb6d584",
        "mistakes": [
            "error_packageheight_messages_1"
        ],
        "warnings": [
            "warning_packageheight_messages_1"
        ]
    },
    "packagelength_messages": {
        "_id": "603402fe84c6e1418eb6d585",
        "mistakes": [
            "error_packagelength_messages_1"
        ],
        "warnings": [
            "warning_packagelength_messages_1"
        ]
    },
    "packagewidth_messages": {
        "_id": "603402fe84c6e1418eb6d586",
        "mistakes": [
            "error_packagewidth_messages_1"
        ],
        "warnings": [
            "warning_packagewidth_messages_1"
        ]
    },
    "price_compare_messages": {
        "_id": "603402fe84c6e1418eb6d587",
        "mistakes": [
            "error_price_compare_messages_1"
        ],
        "warnings": [
            "warning_price_compare_messages_1"
        ]
    },
    "price_messages": {
        "_id": "603402fe84c6e1418eb6d588",
        "mistakes": [
            "error_price_messages_1"
        ],
        "warnings": [
            "warning_price_messages_1"
        ]
    },
    "product_id": "5a16c0bcf82f45273b000054",
    "request": "{}",
    "request_response_id": null,
    "response": "{\"_id\":\"603402fe84c6e1418eb6d579\",\"action\":\"Description update\",\"barcode_messages\":{\"_id\":\"603402fe84c6e1418eb6d57a\",\"mistakes\":[\"error_barcode_messages_1\"],\"warnings\":[\"warning_barcode_messages_1\"]},\"brand_messages\":{\"_id\":\"603402fe84c6e1418eb6d57b\",\"mistakes\":[\"error_brand_messages_1\"],\"warnings\":[\"warning_brand_messages_1\"]},\"category_messages\":{\"_id\":\"603402fe84c6e1418eb6d57c\",\"mistakes\":[\"error_category_messages_1\"],\"warnings\":[\"warning_category_messages_1\"]},\"company_id\":\"5776daa1f82f454fa8000000\",\"condition_messages\":{\"_id\":\"603402fe84c6e1418eb6d57d\",\"mistakes\":[\"error_condition_messages_1\"],\"warnings\":[\"warning_condition_messages_1\"]},\"created_at\":null,\"deliverytimesupplier_messages\":{\"_id\":\"603402fe84c6e1418eb6d57e\",\"mistakes\":[\"error_deliverytimesupplier_messages_1\"],\"warnings\":[\"warning_deliverytimesupplier_messages_1\"]},\"description_messages\":{\"_id\":\"603402fe84c6e1418eb6d57f\",\"mistakes\":[\"error_description_messages_1\"],\"warnings\":[\"warning_description_messages_1\"]},\"gender_messages\":{\"_id\":\"603402fe84c6e1418eb6d580\",\"mistakes\":[\"error_gender_messages_1\"],\"warnings\":[\"warning_gender_messages_1\"]},\"integration_config_id\":\"6012c3c784c6e179b53043f5\",\"is_fullproductname_messages\":{\"_id\":\"603402fe84c6e1418eb6d581\",\"mistakes\":[\"error_is_fullproductname_messages_1\"],\"warnings\":[\"warning_is_fullproductname_messages_1\"]},\"is_last\":null,\"marketplace\":\"centry-test-local-v2\",\"messages\":{\"_id\":\"603402fe84c6e1418eb6d582\",\"mistakes\":[\"error_messages_1\"],\"warnings\":[\"warning_messages_1\"]},\"name_messages\":{\"_id\":\"603402fe84c6e1418eb6d583\",\"mistakes\":[\"error_name_messages_1\"],\"warnings\":[\"warning_name_messages_1\"]},\"packageheight_messages\":{\"_id\":\"603402fe84c6e1418eb6d584\",\"mistakes\":[\"error_packageheight_messages_1\"],\"warnings\":[\"warning_packageheight_messages_1\"]},\"packagelength_messages\":{\"_id\":\"603402fe84c6e1418eb6d585\",\"mistakes\":[\"error_packagelength_messages_1\"],\"warnings\":[\"warning_packagelength_messages_1\"]},\"packagewidth_messages\":{\"_id\":\"603402fe84c6e1418eb6d586\",\"mistakes\":[\"error_packagewidth_messages_1\"],\"warnings\":[\"warning_packagewidth_messages_1\"]},\"price_compare_messages\":{\"_id\":\"603402fe84c6e1418eb6d587\",\"mistakes\":[\"error_price_compare_messages_1\"],\"warnings\":[\"warning_price_compare_messages_1\"]},\"price_messages\":{\"_id\":\"603402fe84c6e1418eb6d588\",\"mistakes\":[\"error_price_messages_1\"],\"warnings\":[\"warning_price_messages_1\"]},\"product_id\":\"5a16c0bcf82f45273b000054\",\"request\":\"{}\",\"request_response_id\":null,\"response\":null,\"saleenddate_messages\":{\"_id\":\"603402fe84c6e1418eb6d589\",\"mistakes\":[\"error_saleenddate_messages_1\"],\"warnings\":[\"warning_saleenddate_messages_1\"]},\"salestartdate_messages\":{\"_id\":\"603402fe84c6e1418eb6d58a\",\"mistakes\":[\"error_salestartdate_messages_1\"],\"warnings\":[\"warning_salestartdate_messages_1\"]},\"season_messages\":{\"_id\":\"603402fe84c6e1418eb6d58b\",\"mistakes\":[\"error_season_messages_1\"],\"warnings\":[\"warning_season_messages_1\"]},\"seasonyear_messages\":{\"_id\":\"603402fe84c6e1418eb6d58c\",\"mistakes\":[\"error_seasonyear_messages_1\"],\"warnings\":[\"warning_seasonyear_messages_1\"]},\"seo_description_messages\":{\"_id\":\"603402fe84c6e1418eb6d58d\",\"mistakes\":[\"error_seo_description_messages_1\"],\"warnings\":[\"warning_seo_description_messages_1\"]},\"seo_title_messages\":{\"_id\":\"603402fe84c6e1418eb6d58e\",\"mistakes\":[\"error_seo_title_messages_1\"],\"warnings\":[\"warning_seo_title_messages_1\"]},\"shortdescription_messages\":{\"_id\":\"603402fe84c6e1418eb6d58f\",\"mistakes\":[\"error_shortdescription_messages_1\"],\"warnings\":[\"warning_shortdescription_messages_1\"]},\"sku_messages\":{\"_id\":\"603402fe84c6e1418eb6d590\",\"mistakes\":[\"error_sku_messages_1\"],\"warnings\":[\"warning_sku_messages_1\"]},\"status_messages\":{\"_id\":\"603402fe84c6e1418eb6d591\",\"mistakes\":[\"error_status_messages_1\"],\"warnings\":[\"warning_status_messages_1\"]},\"success\":null,\"updated_at\":null,\"warranty_messages\":{\"_id\":\"603402fe84c6e1418eb6d592\",\"mistakes\":[\"error_warranty_messages_1\"],\"warnings\":[\"warning_warranty_messages_1\"]}}",
    "saleenddate_messages": {
        "_id": "603402fe84c6e1418eb6d589",
        "mistakes": [
            "error_saleenddate_messages_1"
        ],
        "warnings": [
            "warning_saleenddate_messages_1"
        ]
    },
    "salestartdate_messages": {
        "_id": "603402fe84c6e1418eb6d58a",
        "mistakes": [
            "error_salestartdate_messages_1"
        ],
        "warnings": [
            "warning_salestartdate_messages_1"
        ]
    },
    "season_messages": {
        "_id": "603402fe84c6e1418eb6d58b",
        "mistakes": [
            "error_season_messages_1"
        ],
        "warnings": [
            "warning_season_messages_1"
        ]
    },
    "seasonyear_messages": {
        "_id": "603402fe84c6e1418eb6d58c",
        "mistakes": [
            "error_seasonyear_messages_1"
        ],
        "warnings": [
            "warning_seasonyear_messages_1"
        ]
    },
    "seo_description_messages": {
        "_id": "603402fe84c6e1418eb6d58d",
        "mistakes": [
            "error_seo_description_messages_1"
        ],
        "warnings": [
            "warning_seo_description_messages_1"
        ]
    },
    "seo_title_messages": {
        "_id": "603402fe84c6e1418eb6d58e",
        "mistakes": [
            "error_seo_title_messages_1"
        ],
        "warnings": [
            "warning_seo_title_messages_1"
        ]
    },
    "shortdescription_messages": {
        "_id": "603402fe84c6e1418eb6d58f",
        "mistakes": [
            "error_shortdescription_messages_1"
        ],
        "warnings": [
            "warning_shortdescription_messages_1"
        ]
    },
    "sku_messages": {
        "_id": "603402fe84c6e1418eb6d590",
        "mistakes": [
            "error_sku_messages_1"
        ],
        "warnings": [
            "warning_sku_messages_1"
        ]
    },
    "status_messages": {
        "_id": "603402fe84c6e1418eb6d591",
        "mistakes": [
            "error_status_messages_1"
        ],
        "warnings": [
            "warning_status_messages_1"
        ]
    },
    "success": false,
    "updated_at": "2021-02-22T16:16:14.393-03:00",
    "warranty_messages": {
        "_id": "603402fe84c6e1418eb6d592",
        "mistakes": [
            "error_warranty_messages_1"
        ],
        "warnings": [
            "warning_warranty_messages_1"
        ]
    }
}

HTTP Request

Parámetros URL

Parámetro	Descripción
product_id	El identificador de la relación producto de la que se desea obtener el historial de sincronizaciones

Crear historiales de sincronización de un producto

Este endpoint crea un historial de sincronización de producto.

curl -L -X POST 'https://www.centry.cl/conexion/v1/products/5a16c0bcf82f45273b000054/synchronization_histories.json' \
-H 'Authorization: Bearer <access_token>' \
-H 'Content-Type: application/json' \
--data-raw '{
    "action":"Product update",
    "name_messages":{
        "warnings":["warning_name_messages_1"],
        "mistakes": ["error_name_messages_1"]
    },
    "description_messages":{
        "warnings":["warning_description_messages_1"],
        "mistakes": ["error_description_messages_1"]
    },
    "price_messages":{
        "warnings":["warning_price_messages_1"],
        "mistakes": ["error_price_messages_1"]
    },
    "price_compare_messages":{
        "warnings":["warning_price_compare_messages_1"],
        "mistakes": ["error_price_compare_messages_1"]
    },
    "barcode_messages":{
        "warnings":["warning_barcode_messages_1"],
        "mistakes": ["error_barcode_messages_1"]
    },
    "status_messages":{
        "warnings":["warning_status_messages_1"],
        "mistakes": ["error_status_messages_1"]
    },
    "seo_title_messages":{
        "warnings":["warning_seo_title_messages_1"],
        "mistakes": ["error_seo_title_messages_1"]
    },
    "seo_description_messages":{
        "warnings":["warning_seo_description_messages_1"],
        "mistakes": ["error_seo_description_messages_1"]
    },
    "packageheight_messages":{
        "warnings":["warning_packageheight_messages_1"],
        "mistakes": ["error_packageheight_messages_1"]
    },
    "packagewidth_messages":{
        "warnings":["warning_packagewidth_messages_1"],
        "mistakes": ["error_packagewidth_messages_1"]
    },
    "packagelength_messages":{
        "warnings":["warning_packagelength_messages_1"],
        "mistakes": ["error_packagelength_messages_1"]
    },
    "shortdescription_messages":{
        "warnings":["warning_shortdescription_messages_1"],
        "mistakes": ["error_shortdescription_messages_1"]
    },
    "salestartdate_messages":{
        "warnings":["warning_salestartdate_messages_1"],
        "mistakes": ["error_salestartdate_messages_1"]
    },
    "saleenddate_messages":{
        "warnings":["warning_saleenddate_messages_1"],
        "mistakes": ["error_saleenddate_messages_1"]
    },
    "condition_messages":{
        "warnings":["warning_condition_messages_1"],
        "mistakes": ["error_condition_messages_1"]
    },
    "seasonyear_messages":{
        "warnings":["warning_seasonyear_messages_1"],
        "mistakes": ["error_seasonyear_messages_1"]
    },
    "season_messages":{
        "warnings":["warning_season_messages_1"],
        "mistakes": ["error_season_messages_1"]
    },
    "sku_messages":{
        "warnings":["warning_sku_messages_1"],
        "mistakes": ["error_sku_messages_1"]
    },
    "deliverytimesupplier_messages":{
        "warnings":["warning_deliverytimesupplier_messages_1"],
        "mistakes": ["error_deliverytimesupplier_messages_1"]
    },
    "is_fullproductname_messages":{
        "warnings":["warning_is_fullproductname_messages_1"],
        "mistakes": ["error_is_fullproductname_messages_1"]
    },
    "category_messages":{
        "warnings":["warning_category_messages_1"],
        "mistakes": ["error_category_messages_1"]
    },
    "brand_messages":{
        "warnings":["warning_brand_messages_1"],
        "mistakes": ["error_brand_messages_1"]
    },
    "gender_messages":{
        "warnings":["warning_gender_messages_1"],
        "mistakes": ["error_gender_messages_1"]
    },
    "warranty_messages":{
        "warnings":["warning_warranty_messages_1"],
        "mistakes": ["error_warranty_messages_1"]
    },
    "messages":{
        "warnings":["warning_messages_1"],
        "mistakes": ["error_messages_1"]
    }
}'

HTTP Request

Parámetros URL

Parámetro	Descripción
product	El identificador de la relación producto de la que se desea obtener el historial de sincronizaciones

Parámetros Data

Parámetro	Descripción
success	Indicado el estado de la petición, campo se calcula de manera automática de acuerdo a la presencia de mistakes sólo lectura
action	Listado de acciones disponibles: [“Product save”, “Product create”, “Product update”, “Product unpublish”, “Product delete”, “Image save”, “Description update”, “Active Meli Flex”, “Deactive Meli Flex”]
mistakes	Listado de errores de un campo en específico que no permitieron que la petición haya resultado exitosa
warnings	Listado de advertencias u oportinidades de mejora de un campo en específico que ha pesar de no ser óptimas la petición se realizó de manera exitosa
name_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo name
description_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo description
price_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo price
price_compare_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo price_compare
barcode_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo barcode
status_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo status
seo_title_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo seo_title
seo_description_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo seo_description
packageheight_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo packageheight
packagewidth_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo packagewidth
packagelength_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo packagelength
shortdescription_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo shortdescription
salestartdate_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo salestartdate
saleenddate_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo saleenddate
condition_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo condition
seasonyear_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo seasonyear
season_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo season
sku_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo sku
deliverytimesupplier_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo deliverytimesupplier
is_fullproductname_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo is_fullproductname
category_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo category
brand_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo brand
gender_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo gender
warranty_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo warranty
messages	Objeto con el listado de mistakes y/o warnings relacionados en general con el modelo product

Todos los assets de un producto

Este endpoint entrega todos los assets de un producto.

curl -X GET https://www.centry.cl/conexion/v1/products/5a16c0bcf82f45273b000054/assets.json \
    -H "Authorization: Bearer  <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5fe9fec484c6e1ec5a67d7b8",
        "alt": null,
        "created_at": "2020-12-28T12:50:28.559-03:00",
        "image_content_type": "image/jpeg",
        "image_file_name": "imagen.jpg",
        "image_file_size": 26136,
        "image_fingerprint": "5d3869297ae3e258fa302c1f6d37d54c",
        "image_processing": false,
        "image_updated_at": "2020-12-28T12:50:30.831-03:00",
        "integrations": {},
        "locked_at": null,
        "locked_until": null,
        "name": null,
        "position": 0,
        "updated_at": "2021-02-12T13:11:27.404-03:00"
    },
    {
        "_id": "5fe9fec484c6e1ec5a67d7c02",
        "alt": null,
        "created_at": "2020-12-28T12:51:40.800-03:00",
        "image_content_type": "imagen_2/jpeg",
        "image_file_name": "imagen_2.jpg",
        "image_file_size": 28465,
        "image_fingerprint": "5d3869297ae3e258fa302c1f6d37d56b",
        "image_processing": false,
        "image_updated_at": "2020-12-28T12:51:40.800-03:00",
        "integrations": {},
        "locked_at": null,
        "locked_until": null,
        "name": null,
        "position": 0,
        "updated_at": "2020-12-28T12:51:40.800-03:00"
    }
]

HTTP Request

Parámetros URL

Parámetro	Descripción
product_id	El identificador de la relación producto de la que se desea obtener sus assets

Obtener un asset específico de un producto

Este endpoint entrega un asset en específico de un producto.

curl -X GET https://www.centry.cl/conexion/v1/products/5a16c0bcf82f45273b000054/assets/5fe9fec484c6e1ec5a67d7b8.json \
    -H "Authorization: Bearer  <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5fe9fec484c6e1ec5a67d7b8",
    "alt": null,
    "created_at": "2020-12-28T12:50:28.559-03:00",
    "image_content_type": "image/jpeg",
    "image_file_name": "imagen.jpg",
    "image_file_size": 26136,
    "image_fingerprint": "5d3869297ae3e258fa302c1f6d37d54c",
    "image_processing": false,
    "image_updated_at": "2020-12-28T12:50:30.831-03:00",
    "integrations": {},
    "locked_at": null,
    "locked_until": null,
    "name": null,
    "position": 0,
    "updated_at": "2021-02-12T13:11:27.404-03:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
product_id	El identificador de la relación producto de la que se desea obtener sus assets
asset_id	El identificador del asset que se quiere obtener del producto

Todos los historiales de sincronización de un asset

Este endpoint entrega todos los historiales de sincronización de un asset.

curl -X GET https://www.centry.cl/conexion/v1/products/5a16c0bcf82f45273b000054/assets/5fe9fec484c6e1ec5a67d7b8/synchronization_histories.json \
    -H "Authorization: Bearer  <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
        "_id": "6034fa2c84c6e1418eb6d79c",
        "action": "Product update",
        "alt_messages": {
            "_id": "6034fa2c84c6e1418eb6d79d",
            "mistakes": [
                "errors_alt_messages_1"
            ],
            "warnings": [
                "warning_alt_messages_1"
            ]
        },
        "messages": {
            "_id": "6034fa2c84c6e1418eb6d79e",
            "mistakes": [
                "errors_messages_1"
            ],
            "warnings": [
                "warning_messages_1"
            ]
        },
        "name_messages": {
            "_id": "6034fa2c84c6e1418eb6d79f",
            "mistakes": [
                "errors_name_messages_1"
            ],
            "warnings": [
                "warning_name_messages_1"
            ]
        },
        "position_messages": {
            "_id": "6034fa2c84c6e1418eb6d7a0",
            "mistakes": [
                "errors_position_messages_1"
            ],
            "warnings": [
                "warning_position_messages_1"
            ]
        },
        "url_messages": {
            "_id": "6034fa2c84c6e1418eb6d7a1",
            "mistakes": [
                "errors_url_messages_1"
            ],
            "warnings": [
                "warning_url_messages_1"
            ]
        },
        "asset_id": "5fe9fec484c6e1ec5a67d7b8",
        "company_id": "5776daa1f82f454fa8000000",
        "created_at": "2021-02-23T09:50:52.992-03:00",
        "integration_config_id": "6012c3c784c6e179b53043f5",
        "is_last": null,
        "marketplace": "centry-test-local-v2",
        "product_id": "5a16c0bcf82f45273b000054",
        "request": "{}",
        "request_response_id": null,
        "response": "{\"_id\":\"6034fa2c84c6e1418eb6d79c\",\"action\":\"Product update\",\"alt_messages\":{\"_id\":\"6034fa2c84c6e1418eb6d79d\",\"mistakes\":[\"errors_alt_messages_1\"],\"warnings\":[\"warning_alt_messages_1\"]},\"asset_id\":\"5fe9fec484c6e1ec5a67d7b8\",\"company_id\":\"5776daa1f82f454fa8000000\",\"created_at\":null,\"integration_config_id\":\"6012c3c784c6e179b53043f5\",\"is_last\":null,\"marketplace\":\"centry-test-local-v2\",\"messages\":{\"_id\":\"6034fa2c84c6e1418eb6d79e\",\"mistakes\":[\"errors_messages_1\"],\"warnings\":[\"warning_messages_1\"]},\"name_messages\":{\"_id\":\"6034fa2c84c6e1418eb6d79f\",\"mistakes\":[\"errors_name_messages_1\"],\"warnings\":[\"warning_name_messages_1\"]},\"position_messages\":{\"_id\":\"6034fa2c84c6e1418eb6d7a0\",\"mistakes\":[\"errors_position_messages_1\"],\"warnings\":[\"warning_position_messages_1\"]},\"product_id\":\"5a16c0bcf82f45273b000054\",\"request\":\"{}\",\"request_response_id\":null,\"response\":null,\"success\":null,\"updated_at\":null,\"url_messages\":{\"_id\":\"6034fa2c84c6e1418eb6d7a1\",\"mistakes\":[\"errors_url_messages_1\"],\"warnings\":[\"warning_url_messages_1\"]}}",
        "success": false,
        "updated_at": "2021-02-23T09:50:52.992-03:00"

    }

HTTP Request

Parámetros URL

Parámetro	Descripción
product_id	El identificador de la relación producto de la que se desea obtener el historial de sincronizaciones de un asset
asset_id	El identificador de la relación producto/asset de la que se desea obtener el historial de sincronizaciones de un asset específico

Crear historial de sincronización de un asset

Este endpoint crea un historial de sincronización de un asset de un producto.

curl -L -X POST 'https://www.centry.cl/conexion/v1/products/5a16c0bcf82f45273b000054/assets/5fe9fec484c6e1ec5a67d7b8/synchronization_histories.json' \
-H 'Authorization: Bearer c5b91075622352558f1cfcee548c524bcab3a63b67bdfae0883458f628f9ae0c' \
-H 'Content-Type: application/json' \
--data-raw '{
    "action":"Product update",
    "name_messages":{
  "warnings":["warning_name_messages_1"],
  "mistakes":["errors_name_messages_1"]
},
"alt_messages":{
  "warnings":["warning_alt_messages_1"],
  "mistakes":["errors_alt_messages_1"]
},
"position_messages":{
  "warnings":["warning_position_messages_1"],
  "mistakes":["errors_position_messages_1"]
},
"url_messages":{
  "warnings":["warning_url_messages_1"],
  "mistakes":["errors_url_messages_1"]
},
"messages":{
  "warnings":["warning_messages_1"],
  "mistakes":["errors_messages_1"]
}
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "6034fa2c84c6e1418eb6d79c",
    "action": "Product update",
    "alt_messages": {
        "_id": "6034fa2c84c6e1418eb6d79d",
        "mistakes": [
            "errors_alt_messages_1"
        ],
        "warnings": [
            "warning_alt_messages_1"
        ]
    },
    "asset_id": "5fe9fec484c6e1ec5a67d7b8",
    "company_id": "5776daa1f82f454fa8000000",
    "created_at": "2021-02-23T09:50:52.992-03:00",
    "integration_config_id": "6012c3c784c6e179b53043f5",
    "is_last": null,
    "marketplace": "centry-test-local-v2",
    "messages": {
        "_id": "6034fa2c84c6e1418eb6d79e",
        "mistakes": [
            "errors_messages_1"
        ],
        "warnings": [
            "warning_messages_1"
        ]
    },
    "name_messages": {
        "_id": "6034fa2c84c6e1418eb6d79f",
        "mistakes": [
            "errors_name_messages_1"
        ],
        "warnings": [
            "warning_name_messages_1"
        ]
    },
    "position_messages": {
        "_id": "6034fa2c84c6e1418eb6d7a0",
        "mistakes": [
            "errors_position_messages_1"
        ],
        "warnings": [
            "warning_position_messages_1"
        ]
    },
    "product_id": "5a16c0bcf82f45273b000054",
    "request": "{}",
    "request_response_id": null,
    "response": "{\"_id\":\"6034fa2c84c6e1418eb6d79c\",\"action\":\"Product update\",\"alt_messages\":{\"_id\":\"6034fa2c84c6e1418eb6d79d\",\"mistakes\":[\"errors_alt_messages_1\"],\"warnings\":[\"warning_alt_messages_1\"]},\"asset_id\":\"5fe9fec484c6e1ec5a67d7b8\",\"company_id\":\"5776daa1f82f454fa8000000\",\"created_at\":null,\"integration_config_id\":\"6012c3c784c6e179b53043f5\",\"is_last\":null,\"marketplace\":\"centry-test-local-v2\",\"messages\":{\"_id\":\"6034fa2c84c6e1418eb6d79e\",\"mistakes\":[\"errors_messages_1\"],\"warnings\":[\"warning_messages_1\"]},\"name_messages\":{\"_id\":\"6034fa2c84c6e1418eb6d79f\",\"mistakes\":[\"errors_name_messages_1\"],\"warnings\":[\"warning_name_messages_1\"]},\"position_messages\":{\"_id\":\"6034fa2c84c6e1418eb6d7a0\",\"mistakes\":[\"errors_position_messages_1\"],\"warnings\":[\"warning_position_messages_1\"]},\"product_id\":\"5a16c0bcf82f45273b000054\",\"request\":\"{}\",\"request_response_id\":null,\"response\":null,\"success\":null,\"updated_at\":null,\"url_messages\":{\"_id\":\"6034fa2c84c6e1418eb6d7a1\",\"mistakes\":[\"errors_url_messages_1\"],\"warnings\":[\"warning_url_messages_1\"]}}",
    "success": false,
    "updated_at": "2021-02-23T09:50:52.992-03:00",
    "url_messages": {
        "_id": "6034fa2c84c6e1418eb6d7a1",
        "mistakes": [
            "errors_url_messages_1"
        ],
        "warnings": [
            "warning_url_messages_1"
        ]
    }
}

HTTP Request

Parámetros URL

Parámetro	Descripción
product_id	El identificador de la relación producto de la que se desea obtener el historial de sincronizaciones de un asset
asset_id	El identificador de la relación producto/asset de la que se desea obtener el historial de sincronizaciones de un asset específico

Parámetros Data

Parámetro	Descripción
success	Indicado el estado de la petición, campo se calcula de manera automática de acuerdo a la presencia de mistakes sólo lectura
action	Listado de acciones disponibles: [“Product save”, “Product create”, “Product update”, “Product unpublish”, “Product delete”, “Image save”, “Description update”, “Active Meli Flex”, “Deactive Meli Flex”]
mistakes	Listado de errores de un campo en específico que no permitieron que la petición haya resultado exitosa
warnings	Listado de advertencias u oportunidades de mejora de un campo en específico que ha pesar de no ser óptimas la petición se realizó de manera exitosa
alt_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo alt
position_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo position
url_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo url
messages	Objeto con el listado de mistakes y/o warnings relacionados en general con el modelo asset

Variants

Parámetros

Atributo	Tipo	Descripción
id	string	Identificador de la variante sólo lectura
barcode	string	Código de barras
bulk_upload	boolean
color_id	string	Identificador del color
color_name	string	Nombre del color sólo lectura
company_id	string	Identificador de la compañía sólo lectura
created_at	date-time	Fecha en formato UTC de la creación de la variante sólo lectura
created_by_id	string	Identificador del usuario que creó por el registro sólo lectura
id_shopify	string
integrations	object	Diccionario con información especializada para algunas integraciones
modifier_id	string
original_data	string
position	integer	Posición de una variante en relación a las otras que pertenecen al mismo producto
price	string
price_compare	string
product_id	string	Identificar del producto al cual pertenece la variante
quantity	integer	Stock de la variante deprecado
size_id	string	Identificador de la talla
size_name	string	Nombre de la talla sólo lectura
sku	string	SKU de la variante
updated_at	string	Fecha de la última modificación del registro en Centry sólo lectura
updated_by_id	string	Identificador del usuario que modificó por última vez el registro sólo lectura
version	int	Numero de versión del registro, va aumentando en la medida que se registran actualizaciones sólo lectura

Todas las variantes de la cuenta

Este endpoint entrega todas las variantes de los productos de la cuenta.

curl "https://www.centry.cl/conexion/v1/variants.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
  {
    "_id": "5c2e07488f26c638ca60dc0b",
    "barcode": "123456789",
    "bulk_upload": false,
    "color_id": "580450f61746bf79030001d6",
    "color_name": "Azul",
    "company_id": null,
    "created_at": "2019-01-03T09:59:52.852-03:00",
    "created_by_id": "5c2d1ae68f26c638ca60dc04",
    "custom_data": null,
    "description": "Descripción detallada de la variante del producto",
    "id_mercadolibre": null,
    "id_shopify": null,
    "id_woocommerce": null,
    "integrations": {},
    "modifier_id": null,
    "original_data": null,
    "position": 0,
    "price": null,
    "price_compare": null,
    "product_id": "5c2e07488f26c638ca60dc0a",
    "quantity": 20,
    "size_id": "5804ad46b831a33ada0f5f93",
    "size_name": "S",
    "sku": "variante_12345",
    "updated_at": "2019-01-03T12:29:19.387-03:00",
    "updated_by_id": "5c2d1ae68f26c638ca60dc04",
    "version": 1
  }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/variants.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación. Además, de ser necesario algunos filtros pueden ser concatenados de la forma https://www.centry.cl/conexion/v1/variants.json?<filter>=<valor>&<filter>=<valor>&…

Filtros especiales

Solo pueden ser ocupados para este endpoint en particular.

Filtro	Descripción	Ejemplo
sku	El sku de la variante que se desea recuperar	https://www.centry.cl/conexion/v1/variants.json?sku=00_1

Crear una variante

Este endpoint crea una variante de un producto.

curl -X POST \
  https://www.centry.cl/conexion/v1/variants.json \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "barcode": "<Código de barras de la nueva variante>",
    "color_id": "<Identificador del color de la nueva variante>",
    "product_id": "<Identificador del producto al cual pertenece la nueva variante>",
    "quantity": Stock de la nueva variante,
    "size_id": "<Identificador de la talla de la nueva variante>",
    "sku": "<SKU de la nueva variante>",
    "updated_at": "2017-10-19T12:24:30.029-03:00",
    "updated_by_id": "580450f81746bf7903000216",
    "version": 7
}'

HTTP Request

Obtener una variante específica

Este endpoint entrega una variante en específico.

curl "https://www.centry.cl/conexion/v1/variants/<variant_id>.json" -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "_id": "<Identificador de la variante>",
  "barcode": "<Código de barras de la variante>",
  "bulk_upload": false,
  "color_id": "<Identificador del color>",
  "color_name": "Azul",
  "company_id": null,
  "created_at": "2019-01-03T09:59:52.852-03:00",
  "created_by_id": "5c2d1ae68f26c638ca60dc04",
  "custom_data": null,
  "description": "<Descripción>",
  "id_mercadolibre": null,
  "id_shopify": null,
  "id_woocommerce": null,
  "integrations": {},
  "modifier_id": null,
  "original_data": null,
  "position": 0,
  "price": null,
  "price_compare": null,
  "product_id": "<Identificador del producto>",
  "quantity": 20,
  "size_id": "<Identificador de la talla>",
  "size_name": "S",
  "sku": "<SKU de la variante>",
  "updated_at": "2019-01-03T12:29:19.387-03:00",
  "updated_by_id": "5c2d1ae68f26c638ca60dc04",
  "version": 1
}

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_id	El identificador de la variante a recuperar

Actualizar una variante

Este endpoint actualiza una variante.

curl -X PUT \
  https://www.centry.cl/conexion/v1/variants/<variant_id>.json \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "quantity": 30
}'

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_id	El identificador de la variante a actualizar

Actualizar por SKU

Este endpoint actualiza la variante de un producto.

curl -X PUT https://www.centry.cl/conexion/v1/variants/sku.json \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "sku": "<SKU de la variante a actualizar>",
    "quantity": 20
}'

HTTP Request

Eliminar una variante

Este endpoint elimina una variante.

curl -X DELETE https://www.centry.cl/conexion/v1/variants/<variant_id>.json \
    -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

true

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_id	El identificador de la variante a eliminar

Todos los historiales de sincronización de una variante

Este endpoint entrega todos los historiales de sincronización de variante.

curl -X GET https://www.centry.cl/conexion/v1/variants/<variant_id>/synchronization_histories.json \
    -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "6034137c84c6e1418eb6d62a",
    "action": "Product update",
    "company_id": "5776daa1f82f454fa8000000",
    "created_at": "2021-02-22T17:26:36.833-03:00",
    "description_messages": {
        "_id": "6034137c84c6e1418eb6d62b",
        "mistakes": [
            "error_description_1",
            "error_description_2"
        ],
        "warnings": [
            "warning_description_1",
            "warning_description_1"
        ]
    },
    "integration_config_id": "6012c3c784c6e179b53043f5",
    "is_last": null,
    "marketplace": "centry-test-local-v2",
    "messages": {
        "_id": "6034137c84c6e1418eb6d62c",
        "mistakes": [
            "mistake_1",
            "mistake_2"
        ],
        "warnings": [
            "warning_1",
            "warning_2"
        ]
    },
    "product_id": "5a16c0bcf82f45273b000054",
    "request": "{}",
    "request_response_id": null,
    "response": "{\"_id\":\"6034137c84c6e1418eb6d62a\",\"action\":\"Product update\",\"company_id\":\"5776daa1f82f454fa8000000\",\"created_at\":null,\"description_messages\":{\"_id\":\"6034137c84c6e1418eb6d62b\",\"mistakes\":[\"error_description_1\",\"error_description_2\"],\"warnings\":[\"warning_description_1\",\"warning_description_1\"]},\"integration_config_id\":\"6012c3c784c6e179b53043f5\",\"is_last\":null,\"marketplace\":\"centry-test-local-v2\",\"messages\":{\"_id\":\"6034137c84c6e1418eb6d62c\",\"mistakes\":[\"error_general_1\",\"error_general_2\"],\"warnings\":[\"warning_general_1\",\"warning_general_2\"]},\"product_id\":\"5a16c0bcf82f45273b000054\",\"request\":\"{}\",\"request_response_id\":null,\"response\":null,\"sku_messages\":{\"_id\":\"6034137c84c6e1418eb6d62d\",\"mistakes\":[\"error_sku_1\",\"error_sku_2\"],\"warnings\":[\"warning_sku_1\",\"warning_sku_1\"]},\"success\":null,\"updated_at\":null,\"variant_id\":\"5a16c0bdf82f45273b000056\"}",
    "sku_messages": {
        "_id": "6034137c84c6e1418eb6d62d",
        "mistakes": [
            "error_sku_1",
            "error_sku_2"
        ],
        "warnings": [
            "warning_sku_1",
            "warning_sku_2"
        ]
    },
    "success": false,
    "updated_at": "2021-02-22T17:26:36.833-03:00",
    "variant_id": "5a16c0bdf82f45273b000056"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_id	El identificador de la relación variante de la que se desea obtener el historial de sincronizaciones

Crear historiales de sincronización de una variante

Este endpoint entrega todos los historiales de sincronización de variante.

curl -L -X POST 'https://www.centry.cl/conexion/v1/variants/5a16c0bdf82f45273b000056/synchronization_histories.json' \
-H 'Authorization: Bearer <access_token>' \
-H 'Content-Type: application/json' \
--data-raw '{
    "action":"Product update",
    "description_messages":{
        "warnings":["warning_description_1","warning_description_1"],
        "mistakes": ["error_description_1", "error_description_2"]
    },
    "sku_messages":{
        "warnings":["warning_sku_1","warning_sku_1"],
        "mistakes": ["error_sku_1", "error_sku_2"]
    },
    "messages":{
        "warnings":["warning_general_1","warning_general_2"],
        "mistakes": ["error_general_1", "error_general_2"]
    }
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "_id": "603409fa84c6e1418eb6d5b7",
  "action": "Product create",
  "company_id": "5776daa1f82f454fa8000000",
  "created_at": "2021-02-22T16:46:02.649-03:00",
  "integration_config_id": "6012c3c784c6e179b53043f5",
  "is_last": null,
  "marketplace": "centry-test-local-v2",
  "quantity_messages": {
      "_id": "603409fa84c6e1418eb6d5b9",
      "mistakes": [
          "error_quantity_messages_1"
      ],
      "warnings": [
          "warning_quantity_messages_1"
      ]
  },
  "messages": {
      "_id": "603409fa84c6e1418eb6d5b8",
      "mistakes": [
          "error_messages_1",
          "error_messages_2"
      ],
      "warnings": [
          "warning_messages_1"
      ]
  },
  "product_id": "5a16c0bcf82f45273b000054",
  "request": "{}",
  "request_response_id": null,
  "response": "{\"_id\":\"603409fa84c6e1418eb6d5b7\",\"action\":\"Product create\",\"company_id\":\"5776daa1f82f454fa8000000\",\"created_at\":null,\"integration_config_id\":\"6012c3c784c6e179b53043f5\",\"is_last\":null,\"marketplace\":\"centry-test-local-v2\",\"messages\":{\"_id\":\"603409fa84c6e1418eb6d5b8\",\"mistakes\":[\"error_messages_1\",\"error_messages_2\"],\"warnings\":[\"warning_messages_1\"]},\"product_id\":\"5a16c0bcf82f45273b000054\",\"quantity_messages\":{\"_id\":\"603409fa84c6e1418eb6d5b9\",\"mistakes\":[\"error_quantity_messages_1\",\"error_quantity_messages_2\",\"error_quantity_messages_3\"],\"warnings\":[\"warning_quantity_messages_1\"]},\"request\":\"{}\",\"request_response_id\":null,\"response\":null,\"success\":null,\"updated_at\":null,\"variant_id\":\"5a16c0bdf82f45273b000056\",\"variant_warehouse_id\":\"5a16d9a1f82f45273b001576\"}",
  "success": false,
  "updated_at": "2021-02-22T16:46:02.649-03:00",
  "variant_id": "5a16c0bdf82f45273b000056",
  "variant_warehouse_id": "5a16d9a1f82f45273b001576"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_warehouse_id	El identificador de la relación variante de la que se desea obtener el historial de sincronizaciones

Parámetros Data

Parámetro	Descripción
success	Indicado el estado de la petición, campo se calcula de manera automática de acuerdo a la presencia de mistakes sólo lectura
action	Listado de acciones disponibles: [“Product save”, “Product create”, “Product update”, “Product unpublish”, “Product delete”, “Image save”, “Description update”, “Active Meli Flex”, “Deactive Meli Flex”]
mistakes	Listado de errores de un campo en específico que no permitieron que la petición haya resultado exitosa
warnings	Listado de advertencias u oportinidades de mejora de un campo en específico que ha pesar de no ser óptimas la petición se realizó de manera exitosa
description_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo description
sku_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo sku
messages	Objeto con el listado de mistakes y/o warnings relacionados en general con el modelo variant_warehouse

Warehouses

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador del warehouse sólo lectura
name	string	Nombre con el cual se puede reconocer la bodega
address	string	Dirección donde se encuentra ubicada la bodega
country_id	string	Identificador del país. Ver endpoint Countries
region_id	string	Identificador de la región. Ver endpoint Regions
city_id	string	Identificador de la ciudad. Ver endpoint Cities
commune_id	string	Identificador de la comuna. Ver endpoint Communes
latitude	string	Número decimal con la latitud de la ubicación geográfica de la bodega
longitude	string	Número decimal con la longitud de la ubicación geográfica de la bodega
integrations	object	Diccionario con información especializada para algunas integraciones
company_id	string	Identificador de empresa sólo lectura
created_at	string	Fecha de creación del warehouse en Centry sólo lectura
updated_at	string	Fecha de la última modificación del warehouse en Centry sólo lectura

Listar las bodegas de la cuenta

Este endpoint entrega todas las bodegas registradas en la cuenta.

curl -X GET \
  https://www.centry.cl/conexion/v1/warehouses.json \
  -H 'authorization: Bearer <access_token>' \

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "577eb7b8f82f456ef4000001",
        "address": "Aurelio González 3838, oficina 02",
        "city_id": null,
        "commune_id": "5769714df82f456e80000169",
        "company_id": "577eb7b8f82f456ef4000000",
        "country_id": null,
        "created_at": "2016-07-07T16:12:40.079-04:00",
        "integrations": {},
        "latitude": "",
        "longitude": "",
        "name": "Casa matriz",
        "region_id": "5769714df82f456e80000001",
        "updated_at": "2019-09-24T13:39:44.792-03:00"
    },
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar el request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/warehouses.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación.

Filtros especiales

Sólo pueden ser ocupados para este endpoint en particular.

Filtro	Descripción	Ejemplo
name	Buscar por el nombre exacto de una bodega	https://www.centry.cl/conexion/v1/warehouses.json?name=Casa%20matriz
address	Buscar por la dirección exacta de una bodega	https://www.centry.cl/conexion/v1/warehouses.json?address=Aurelio20González203838,20oficina2002
latitude	Buscar por la latitud geográfica exacta de una bodega	https://www.centry.cl/conexion/v1/warehouses.json?latitude=
longitude	Buscar por la longitud geográfica exacta de una bodega	https://www.centry.cl/conexion/v1/warehouses.json?longitude=

Obtener una bodega específica

Este endpoint entrega una bodega específica.

curl -X GET \
  https://www.centry.cl/conexion/v1/warehouses/577eb7b8f82f456ef4000001.json \
  -H 'authorization: Bearer <access_token>' \

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "577eb7b8f82f456ef4000001",
    "address": "Badajoz 100, oficina 407",
    "city_id": null,
    "commune_id": "5769714df82f456e80000169",
    "company_id": "577eb7b8f82f456ef4000000",
    "country_id": null,
    "created_at": "2016-07-07T16:12:40.079-04:00",
    "integrations": {},
    "latitude": "",
    "longitude": "",
    "name": "Casa matriz",
    "region_id": "5769714df82f456e80000001",
    "updated_at": "2019-09-24T13:39:44.792-03:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
warehouse_id	El identificador de la bodega a recuperar

Crear una bodega

Este endpoint permite crear una bodega nueva.

curl -X POST \
  https://www.centry.cl/conexion/v1/warehouses.json \
  -H 'authorization: Bearer <access_token>' \
  -H 'content-type: application/json' \
  -d '{
    "name": "Demo",
    "address": "Calle principal 5500",
    "latitude": 70.04,
    "longitude": -30.43
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5dd2f56a48f0393d1d17f984",
    "address": "Calle principal 5500",
    "city_id": null,
    "commune_id": null,
    "company_id": "577eb7b8f82f456ef4000000",
    "country_id": null,
    "created_at": "2019-11-18T16:47:54.309-03:00",
    "latitude": "70.04",
    "longitude": "-30.43",
    "name": "Demo",
    "region_id": null,
    "updated_at": "2019-11-18T16:47:54.309-03:00"
}

HTTP Request

Actualizar una bodega

Este endpoint permite modificar una bodega específica.

curl -X PUT \
  https://www.centry.cl/conexion/v1/warehouses/5dd2f56a48f0393d1d17f984.json \
  -H 'authorization: Bearer <access_token>' \
  -H 'content-type: application/json' \
  -d '{
    "address": "Nuevo nombre",
    "longitude": 25.05
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5dd2f56a48f0393d1d17f984",
    "address": "Calle principal 5500",
    "city_id": null,
    "commune_id": null,
    "company_id": "577eb7b8f82f456ef4000000",
    "country_id": null,
    "created_at": "2019-11-18T16:47:54.309-03:00",
    "latitude": "70.04",
    "longitude": "25.05",
    "name": "Nuevo nombre",
    "region_id": null,
    "updated_at": "2019-11-18T16:47:54.309-03:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
warehouse_id	El identificador de la bodega a actualizar

Eliminar una bodega

Este endpoint elimina permanentemente una bodega específica.

curl -X DELETE \
  https://www.centry.cl/conexion/v1/warehouses/59c9852d1746bf1d93000001.json \
  -H 'authorization: Bearer <access_token>'

Lo anterior retorna un JSON estructurado de la siguiente manera:

true

HTTP Request

Parámetros URL

Parámetro	Descripción
warehouse_id	El identificador de la bodega a eliminar

VariantWarehouses

Este modelo es el encargado de relacionar las variantes de un producto con las bodegas para llevar el control del stock.

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador de la relación variante-bodega sólo lectura
variant_id	string	Identificador de la variante. Ver endpoint Variants
warehouse_id	string	Identificador de la bodega. Ver endpoint Warehouses
quantity	integer	Stock que registra la variante en una bodega
created_by_id	string	Identificador del usuario que creó por el registro sólo lectura
modifier_id	string	Identificador del usuario que modificó por última vez el registro sólo lectura
created_at	string	Fecha de creación del registro en Centry sólo lectura
updated_at	string	Fecha de la última modificación del registro en Centry sólo lectura
version	integer	Numero de versión del registro, va aumentando en la medida que se registran actualizaciones sólo lectura

Todas las variante-bodegas de la cuenta

Este endpoint entrega todas las relaciones variante-bodega de la cuenta.

curl "https://www.centry.cl/conexion/v1/variant_warehouses.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5ac23e71f82f455978672393",
        "created_at": "2018-04-02T11:30:09.723-03:00",
        "created_by_id": null,
        "modifier_id": null,
        "quantity": 2,
        "updated_at": "2019-10-03T13:55:09.068-03:00",
        "updated_by_id": "577eb7b8f82f456ef4000002",
        "variant_id": "5ac23e71f82f455978672392",
        "version": 11,
        "warehouse_id": "577eb7b8f82f456ef4000001"
    },
    {
        "_id": "5cc36d8748f039156b45f78d",
        "created_at": "2019-04-26T16:43:51.125-04:00",
        "created_by_id": "577eb7b8f82f456ef4000002",
        "modifier_id": null,
        "quantity": 2,
        "updated_at": "2019-10-17T19:06:45.114-03:00",
        "updated_by_id": "577eb7b8f82f456ef4000002",
        "variant_id": "5cc36d8748f039156b45f78c",
        "version": 9,
        "warehouse_id": "577eb7b8f82f456ef4000001"
    },
    {
        "_id": "5cc36d8748f039156b45f78f",
        "created_at": "2019-04-26T16:43:51.152-04:00",
        "created_by_id": "577eb7b8f82f456ef4000002",
        "modifier_id": null,
        "quantity": 2,
        "updated_at": "2019-10-17T19:06:45.072-03:00",
        "updated_by_id": "577eb7b8f82f456ef4000002",
        "variant_id": "5cc36d8748f039156b45f78e",
        "version": 8,
        "warehouse_id": "577eb7b8f82f456ef4000001"
    }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar el request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/variant_warehouses.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación.

Filtros especiales

Sólo pueden ser ocupados para este endpoint en particular.

Filtro	Descripción	Ejemplo
variant_id	El identificador de la variante que se desea recuperar	https://www.centry.cl/conexion/v1/variant_warehouses.json?variant_id=5cc36d8748f039156b45f78e
warehouse_id	El identificador de la bodega que se desea recuperar	https://www.centry.cl/conexion/v1/variant_warehouses.json?warehouse_id=577eb7b8f82f456ef4000001

Crear una variante-bodega

Este endpoint crea una relación variante-bodega en la cuenta.

curl -X POST \
  https://www.centry.cl/conexion/v1/variant_warehouses.json \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "quantity": 2,
    "variant_id": "5cc36d8748f039156b45f78e",
    "warehouse_id": "577eb7b8f82f456ef4000001"
}'

HTTP Request

Obtener una variante-bodega específica

Este endpoint entrega una relación variante-bodega en específica.

curl "https://www.centry.cl/conexion/v1/variant_warehouses/<variant_warehouse_id>.json" -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5cc36d8748f039156b45f78f",
    "created_at": "2019-04-26T16:43:51.152-04:00",
    "created_by_id": "577eb7b8f82f456ef4000002",
    "modifier_id": null,
    "quantity": 2,
    "updated_at": "2019-10-17T19:06:45.072-03:00",
    "updated_by_id": "577eb7b8f82f456ef4000002",
    "variant_id": "5cc36d8748f039156b45f78e",
    "version": 8,
    "warehouse_id": "577eb7b8f82f456ef4000001"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_warehouse_id	El identificador de la relación variante-bodega a recuperar

Actualizar una variante-bodega

Este endpoint actualiza una relación variante-bodega.

curl -X PUT \
  https://www.centry.cl/conexion/v1/variant_warehouses/<variant_warehouse_id>.json \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "quantity": 30
}'

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_warehouse_id	El identificador de la relación variante-bodega a actualizar

Eliminar una Variante-Bodega

Este endpoint elimina una relación variante-bodega.

curl -X DELETE https://www.centry.cl/conexion/v1/variant_warehouses/<variant_warehouse_id>.json \
    -H "Authorization: Bearer  <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

true

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_warehouse_id	El identificador de la relación variante-bodega a eliminar

Todos los historiales de sincronización de una variante-bodega

Este endpoint entrega todos los historiales de sincronización de variante-bodega.

curl -X GET https://www.centry.cl/conexion/v1/variant_warehouses/<variant_warehouse_id>/synchronization_histories.json \
    -H "Authorization: Bearer  <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
   "_id": "603409fa84c6e1418eb6d5b7",
   "action": "Product create",
   "company_id": "5776daa1f82f454fa8000000",
   "created_at": "2021-02-22T16:46:02.649-03:00",
   "integration_config_id": "6012c3c784c6e179b53043f5",
   "is_last": null,
   "marketplace": "centry-test-local-v2",
   "messages": {
       "_id": "603409fa84c6e1418eb6d5b8",
       "mistakes": [
           "error_messages_1",
           "error_messages_2"
       ],
       "warnings": [
           "warning_messages_1"
       ]
   },
   "product_id": "5a16c0bcf82f45273b000054",
   "quantity_messages": {
       "_id": "603409fa84c6e1418eb6d5b9",
       "mistakes": [
           "error_quantity_messages_1",
           "error_quantity_messages_2",
           "error_quantity_messages_3"
       ],
       "warnings": [
           "warning_quantity_messages_1"
       ]
   },
   "request": "{}",
   "request_response_id": null,
   "response": "{\"_id\":\"603409fa84c6e1418eb6d5b7\",\"action\":\"Product create\",\"company_id\":\"5776daa1f82f454fa8000000\",\"created_at\":null,\"integration_config_id\":\"6012c3c784c6e179b53043f5\",\"is_last\":null,\"marketplace\":\"centry-test-local-v2\",\"messages\":{\"_id\":\"603409fa84c6e1418eb6d5b8\",\"mistakes\":[\"error_messages_1\",\"error_messages_2\"],\"warnings\":[\"warning_messages_1\"]},\"product_id\":\"5a16c0bcf82f45273b000054\",\"quantity_messages\":{\"_id\":\"603409fa84c6e1418eb6d5b9\",\"mistakes\":[\"error_quantity_messages_1\",\"error_quantity_messages_2\",\"error_quantity_messages_3\"],\"warnings\":[\"warning_quantity_messages_1\"]},\"request\":\"{}\",\"request_response_id\":null,\"response\":null,\"success\":null,\"updated_at\":null,\"variant_id\":\"5a16c0bdf82f45273b000056\",\"variant_warehouse_id\":\"5a16d9a1f82f45273b001576\"}",
   "success": false,
   "updated_at": "2021-02-22T16:46:02.649-03:00",
   "variant_id": "5a16c0bdf82f45273b000056",
   "variant_warehouse_id": "5a16d9a1f82f45273b001576"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_warehouse_id	El identificador de la relación variante-bodega de la que se desea obtener el historial de sincronizaciones

Crear historiales de sincronización de una variante-bodega

Este endpoint entrega todos los historiales de sincronización de variante-bodega.

curl -X POST 'https://www.centry.cl/conexion/v1/variant_warehouses/<variant_warehouse_id>/synchronization_histories.json' \
--header 'Authorization: Bearer  <access_token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action":"Product create",
    "quantity_messages":{
        "warnings":["warning_quantity_messages_1"],
        "mistakes": ["error_quantity_messages_1"]
    },
    "messages":{
        "warnings":["warning_messages_1"],
        "mistakes": ["error_messages_1"]
    }
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "_id": "603409fa84c6e1418eb6d5b7",
  "action": "Product create",
  "company_id": "5776daa1f82f454fa8000000",
  "created_at": "2021-02-22T16:46:02.649-03:00",
  "integration_config_id": "6012c3c784c6e179b53043f5",
  "is_last": null,
  "marketplace": "centry-test-local-v2",
  "quantity_messages": {
      "_id": "603409fa84c6e1418eb6d5b9",
      "mistakes": [
          "error_quantity_messages_1"
      ],
      "warnings": [
          "warning_quantity_messages_1"
      ]
  },
  "messages": {
      "_id": "603409fa84c6e1418eb6d5b8",
      "mistakes": [
          "error_messages_1",
          "error_messages_2"
      ],
      "warnings": [
          "warning_messages_1"
      ]
  },
  "product_id": "5a16c0bcf82f45273b000054",
  "request": "{}",
  "request_response_id": null,
  "response": "{\"_id\":\"603409fa84c6e1418eb6d5b7\",\"action\":\"Product create\",\"company_id\":\"5776daa1f82f454fa8000000\",\"created_at\":null,\"integration_config_id\":\"6012c3c784c6e179b53043f5\",\"is_last\":null,\"marketplace\":\"centry-test-local-v2\",\"messages\":{\"_id\":\"603409fa84c6e1418eb6d5b8\",\"mistakes\":[\"error_messages_1\",\"error_messages_2\"],\"warnings\":[\"warning_messages_1\"]},\"product_id\":\"5a16c0bcf82f45273b000054\",\"quantity_messages\":{\"_id\":\"603409fa84c6e1418eb6d5b9\",\"mistakes\":[\"error_quantity_messages_1\",\"error_quantity_messages_2\",\"error_quantity_messages_3\"],\"warnings\":[\"warning_quantity_messages_1\"]},\"request\":\"{}\",\"request_response_id\":null,\"response\":null,\"success\":null,\"updated_at\":null,\"variant_id\":\"5a16c0bdf82f45273b000056\",\"variant_warehouse_id\":\"5a16d9a1f82f45273b001576\"}",
  "success": false,
  "updated_at": "2021-02-22T16:46:02.649-03:00",
  "variant_id": "5a16c0bdf82f45273b000056",
  "variant_warehouse_id": "5a16d9a1f82f45273b001576"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_warehouse_id	El identificador de la relación variante-bodega de la que se desea obtener el historial de sincronizaciones

Parámetros Data

Parámetro	Descripción
success	Indicado el estado de la petición, campo se calcula de manera automática de acuerdo a la presencia de mistakes sólo lectura
action	Listado de acciones disponibles: [“Product save”, “Product create”, “Product update”, “Product unpublish”, “Product delete”, “Image save”, “Description update”, “Active Meli Flex”, “Deactive Meli Flex”]
mistakes	Listado de errores de un campo en específico que no permitieron que la petición haya resultado exitosa
warnings	Listado de advertencias u oportinidades de mejora de un campo en específico que ha pesar de no ser óptimas la petición se realizó de manera exitosa
quantity_messages	Objeto con el listado de mistakes y/o warnings relacionados con el atributo quantity
messages	Objeto con el listado de mistakes y/o warnings relacionados en general con el modelo variant_warehouse

VariantAssets

Este modelo es el encargado de relacionar las variantes de un producto con las imágenes del producto.

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador de la relación variante-imagen sólo lectura
variant_id	string	Identificador de la variante. Ver endpoint Variants
asset_id	string	Identificador de la imagen. Ver endpoint Warehouses
product_id	integer	Identificador del producto. Ver endpoint Products
position	string	Posición de la imagen en la variante.
created_at	string	Fecha de creación del registro en Centry sólo lectura
updated_at	string	Fecha de la última modificación del registro en Centry sólo lectura

Todas las variante-imágenes de la variante

Este endpoint entrega todas las relaciones variante-imagen de una variante.

curl "https://www.centry.cl/conexion/v1/variants/<variant_id>/assets.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5ac23e71f82f455978672393",
        "created_at": "2018-04-02T11:30:09.723-03:00",
        "position": 0,
        "updated_at": "2019-10-03T13:55:09.068-03:00",
        "variant_id": "5ac23e71f82f455978672392",
        "product_id": "577eb7b8f82f456ef4000002",
        "asset_id": "577eb7b8f82f456ef4000001"
    },
    {
        "_id": "5ac23e71f82f455978672394",
        "created_at": "2018-04-02T11:30:09.723-03:00",
        "position": 0,
        "updated_at": "2019-10-03T13:55:09.068-03:00",
        "variant_id": "5ac23e71f82f455978672392",
        "product_id": "577eb7b8f82f456ef4000002",
        "asset_id": "577eb7b8f82f456ef4000002"
    },
    {
        "_id": "5ac23e71f82f455978672395",
        "created_at": "2018-04-02T11:30:09.723-03:00",
        "position": 0,
        "updated_at": "2019-10-03T13:55:09.068-03:00",
        "variant_id": "5ac23e71f82f455978672392",
        "product_id": "577eb7b8f82f456ef4000002",
        "asset_id": "577eb7b8f82f456ef4000003"
    },
]

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_id	El identificador de la variante.

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar el request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/variants/<variant_id>/assets.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación.

Crear una variante-imagen

Este endpoint crea una relación variante-imagen.

curl -X POST \
  https://www.centry.cl/conexion/v1/variants/<variant_id>/assets.json \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "asset_id": "577eb7b8f82f456ef4000001"
}'

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_id	El identificador de la variante.

Obtener una variante-imagen específica

Este endpoint entrega una relación variante-imagen en específica.

curl "https://www.centry.cl/conexion/v1/variants/<variant_id>/assets/<variant_asset_id>.json" -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5ac23e71f82f455978672394",
    "created_at": "2018-04-02T11:30:09.723-03:00",
    "position": 0,
    "updated_at": "2019-10-03T13:55:09.068-03:00",
    "variant_id": "5ac23e71f82f455978672392",
    "product_id": "577eb7b8f82f456ef4000002",
    "asset_id": "577eb7b8f82f456ef4000002"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_id	El identificador de la variante.
variant_asset_id	El identificador de la relación variante-imagen a recuperar

Eliminar una relacion variante imagen

Este endpoint elimina una relación variante-imagen.

curl -X DELETE https://www.centry.cl/conexion/v1/variants/<variant_id>/assets/<variant_asset_id>.json \
    -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

true

HTTP Request

Parámetros URL

Parámetro	Descripción
variant_id	El identificador de la variante.
variant_asset_id	El identificador de la relación variante-imagen a recuperar

Categories

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador de la categoría sólo lectura
name	string	Nombre de la categoría en Centry sólo lectura
created_at	string	Registro de creación de la categoría sólo lectura
updated_at	string	Registro de última actualización sólo lectura

Todas las categorías

Este endpoint entrega todas las categorías de Centry.

curl "https://www.centry.cl/conexion/v1/categories.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5769714df82f456e809571a7",
        "created_at": "2016-06-21T16:54:37.823Z",
        "name": "Accesorios / Accesorios Femeninos / Anteojos",
        "updated_at": "2016-06-21T16:54:37.823Z"
    },
    {
        "_id": "5769714df82f456e809381a5",
        "created_at": "2016-06-21T16:54:37.821Z",
        "name": "Accesorios / Accesorios Femeninos / Bijuteria / Anillos",
        "updated_at": "2016-06-21T16:54:37.821Z"
    }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/categories.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación. Además, de ser necesario algunos filtros pueden ser concatenados de la forma https://www.centry.cl/conexion/v1/categories.json?<filter>=<valor>&<filter>=<valor>&…

Filtros especiales

Solo pueden ser ocupados para este endpoint en particular.

Filtro	Descripción	Ejemplo
filtered_used_by_company	Muestra sólo las categorías usadas actualmente por la empresa	https://www.centry.cl/conexion/v1/categories.json?created_at=2017-09-13T21:00:00.000-03:00&filtered_used_by_company

Obtener una categoría específica

Este endpoint entrega una categoría específica.

curl "https://www.centry.cl/conexion/v1/categories/<category_id>.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5769714df82f456e809381a5",
    "created_at": "2016-06-21T16:54:37.821Z",
    "name": "Accesorios / Accesorios Femeninos / Bijuteria / Anillos",
    "updated_at": "2016-06-21T16:54:37.821Z"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
category_id	El identificador de la categoría a recuperar

Brands

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador de la marca sólo lectura
name	string	Nombre de la marca en Centry sólo lectura
created_at	string	Registro de creación de la marca en Centry sólo lectura
updated_at	string	Registro de última actualización sólo lectura

Todas las marcas

Este endpoint entrega todas las marcas de Centry.

curl "https://www.centry.cl/conexion/v1/brands.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

[

    {
    "_id": "57f63ffe4c266d1dec1edfb6",
    "created_at": "2016-08-28T16:21:37.882Z",
    "name": "Bata",
    "updated_at": "2016-08-28T16:21:37.882Z"
  },
  {
    "_id": "58124d68fd246926928fed3c",
    "created_at": "2016-10-01T19:35:14.734Z",
    "name": "ZIKO",
    "updated_at": "2016-10-01T19:35:14.734Z"
  }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/brands.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación. Además, de ser necesario algunos filtros pueden ser concatenados de la forma https://www.centry.cl/conexion/v1/brands.json?<filter>=<valor>&<filter>=<valor>&…

Filtros especiales

Solo pueden ser ocupados para este endpoint en particular.

Filtro	Descripción	Ejemplo
filtered_used_by_company	Muestra sólo las marcas usadas actualmente por la empresa	https://www.centry.cl/conexion/v1/brands.json?created_at=2017-09-13T21:00:00.000-03:00&filtered_used_by_company

Obtener una marca específica

Este endpoint entrega una marca específico.

curl "https://www.centry.cl/conexion/v1/brands/<brand_id>.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "_id": "58124d68fd246926928fed3c",
  "created_at": "2016-10-01T19:35:14.734Z",
  "name": "ZIKO",
  "updated_at": "2016-10-01T19:35:14.734Z"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
brand_id	El identificador de la marca a recuperar

Colors

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador del color sólo lectura
name	string	Nombre de color en Centry sólo lectura
created_at	string	Registro de creación de color en Centry sólo lectura
updated_at	string	Registro de última actualización sólo lectura

Todos los colores

Este endpoint entrega todos los colores de Centry.

curl "https://www.centry.cl/conexion/v1/colors.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "588a28c40fb756a249fd0c78",
        "created_at": "2016-10-01T00:00:00.000Z",
        "name": "Violeta oscuro",
        "updated_at": "2016-10-01T00:00:00.000Z"
    },
    {
        "_id": "588a28c40fb756a249fd0c77",
        "created_at": "2016-10-01T00:00:00.000Z",
        "name": "Verde oscuro",
        "updated_at": "2016-10-01T00:00:00.000Z"
    }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/colors.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación. Además, de ser necesario algunos filtros pueden ser concatenados de la forma https://www.centry.cl/conexion/v1/colors.json?<filter>=<valor>&<filter>=<valor>&…

Obtener un color específico

Este endpoint entrega un color específico.

curl "https://www.centry.cl/conexion/v1/colors/<color_id>.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "588a28c40fb756a249fd0c78",
    "created_at": "2016-10-01T00:00:00.000Z",
    "name": "Violeta oscuro",
    "updated_at": "2016-10-01T00:00:00.000Z"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
color_id	El identificador del color a recuperar

Sizes

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador de la talla sólo lectura
name	string	Nombre de la talla en Centry sólo lectura
created_at	string	Registro de creación de la talla en Centry sólo lectura
updated_at	string	Registro de última actualización sólo lectura

Todas las tallas

Este endpoint entrega todas las tallas de Centry

curl "https://www.centry.cl/conexion/v1/sizes.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5851b0c2b2c85e8282262a3e",
        "created_at": "2016-10-01T00:00:00.000Z",
        "name": "Tamaño Único",
        "updated_at": "2016-10-01T00:00:00.000Z"
    },
    {
        "_id": "5851b0c2b2c85e8282262a3f",
        "created_at": "2016-10-01T00:00:00.000Z",
        "name": "XXS",
        "updated_at": "2016-10-01T00:00:00.000Z"
    }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/sizes.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación. Además, de ser necesario algunos filtros pueden ser concatenados de la forma https://www.centry.cl/conexion/v1/sizes.json?<filter>=<valor>&<filter>=<valor>&…

Obtener una talla específica

Este endpoint entrega una talla específica

curl "https://www.centry.cl/conexion/v1/sizes/<size_id>.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5851b0c2b2c85e8282262a3f",
    "created_at": "2016-10-01T00:00:00.000Z",
    "name": "XXS",
    "updated_at": "2016-10-01T00:00:00.000Z"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
size_id	El identificador de la talla a recuperar

Countries

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador del país sólo lectura
name	string	Nombre del país en Centry sólo lectura
iso_code	string	Código del país según la norma ISO sólo lectura
language	string	Código que identifica el idioma principal del país sólo lectura
created_at	string	Fecha de creación del país en Centry sólo lectura
updated_at	string	Fecha de la última actualización sólo lectura

Todos los países

Este endpoint entrega todas los países de Centry.

curl "https://www.centry.cl/conexion/v1/locations/countries.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5769714df82f456e80000000",
        "created_at": "2016-06-21T12:54:37.367-04:00",
        "iso_code": "CL",
        "language": "es",
        "name": "Chile",
        "updated_at": "2016-06-21T12:54:37.367-04:00"
    }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/locations/countries.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación.

Filtros especiales

Solo pueden ser ocupados para este endpoint en particular.

Filtro	Descripción	Ejemplo
iso_code	Busca paises por el código iso exacto	https://www.centry.cl/conexion/v1/locations/countries.json?iso_code=CL
language	Busca países por el código de idioma exacto	https://www.centry.cl/conexion/v1/locations/countries.json?language=es
name	Busca países por el nombre el nombre exacto	https://www.centry.cl/conexion/v1/locations/countries.json?name=Chile

Obtener un país específico

Este endpoint entrega un país específico.

curl "https://www.centry.cl/conexion/v1/locations/countries/<country_id>.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5769714df82f456e80000000",
    "created_at": "2016-06-21T12:54:37.367-04:00",
    "iso_code": "CL",
    "language": "es",
    "name": "Chile",
    "updated_at": "2016-06-21T12:54:37.367-04:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
country_id	El identificador del país a recuperar

Regions

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador de la región sólo lectura
name	string	Nombre de la región en Centry sólo lectura
country_id	string	Identificador de la región al que pertenece la región sólo lectura
position	integer	Posición de la región dentro del listado perteneciente a una región sólo lectura
created_at	string	Fecha de creación de la región en Centry sólo lectura
updated_at	string	Fecha de la última actualización sólo lectura

Todas las regiones

Este endpoint entrega todas las regiones de Centry.

curl "https://www.centry.cl/conexion/v1/locations/regions.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5769714df82f456e80000001",
        "country_id": "5769714df82f456e80000000",
        "created_at": "2016-06-21T12:54:37.370-04:00",
        "name": "Región Metropolitana",
        "position": 1,
        "updated_at": "2016-06-21T12:54:37.370-04:00"
    },
    {
        "_id": "5769714df82f456e8000000e",
        "country_id": "5769714df82f456e80000000",
        "created_at": "2016-06-21T12:54:37.389-04:00",
        "name": "XIV Región: Los Ríos",
        "position": 14,
        "updated_at": "2016-06-21T12:54:37.389-04:00"
    },
    {
        "_id": "5769714df82f456e8000000d",
        "country_id": "5769714df82f456e80000000",
        "created_at": "2016-06-21T12:54:37.388-04:00",
        "name": "XII Región: Magallanes",
        "position": 13,
        "updated_at": "2016-06-21T12:54:37.388-04:00"
    }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/locations/regions.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación.

Filtros especiales

Solo pueden ser ocupados para este endpoint en particular.

Filtro	Descripción	Ejemplo
country_id	Busca regiones que pertenezcan a una región específica	https://www.centry.cl/conexion/v1/locations/regions.json?country_id=5769714df82f456e80000000
name	Busca regiones por el nombre el nombre exacto	https://www.centry.cl/conexion/v1/locations/regions.json?name=Región%20Metropolitana
position	Busca regiones que tengan una posición específica	https://www.centry.cl/conexion/v1/locations/regions.json?position=3

Obtener una región específica

Este endpoint entrega una región específica.

curl "https://www.centry.cl/conexion/v1/locations/regions/<region_id>.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5769714df82f456e80000001",
    "country_id": "5769714df82f456e80000000",
    "created_at": "2016-06-21T12:54:37.370-04:00",
    "name": "Región Metropolitana",
    "position": 1,
    "updated_at": "2016-06-21T12:54:37.370-04:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
region_id	El identificador de la región a recuperar

Cities

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador de la ciudad sólo lectura
name	string	Nombre de la ciudad en Centry sólo lectura
region_id	string	Identificador de la región a la que pertenece la ciudad sólo lectura
created_at	string	Fecha de creación de la ciudad en Centry sólo lectura
updated_at	string	Fecha de la última actualización sólo lectura

Todas las ciudades

Este endpoint entrega todas las ciudades de Centry.

curl "https://www.centry.cl/conexion/v1/locations/cities.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5769714df82f456e8000003f",
        "created_at": "2016-06-21T12:54:37.440-04:00",
        "name": "Maipo",
        "region_id": "5769714df82f456e80000001",
        "updated_at": "2016-06-21T12:54:37.440-04:00"
    },
    {
        "_id": "5769714df82f456e8000003d",
        "created_at": "2016-06-21T12:54:37.438-04:00",
        "name": "Cordillera",
        "region_id": "5769714df82f456e80000001",
        "updated_at": "2016-06-21T12:54:37.438-04:00"
    },
    {
        "_id": "5769714df82f456e8000003e",
        "created_at": "2016-06-21T12:54:37.439-04:00",
        "name": "Chacabuco",
        "region_id": "5769714df82f456e80000001",
        "updated_at": "2016-06-21T12:54:37.439-04:00"
    },
    {
        "_id": "5769714df82f456e8000003c",
        "created_at": "2016-06-21T12:54:37.437-04:00",
        "name": "Santiago",
        "region_id": "5769714df82f456e80000001",
        "updated_at": "2016-06-21T12:54:37.437-04:00"
    }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/locations/cities.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación.

Filtros especiales

Solo pueden ser ocupados para este endpoint en particular.

Filtro	Descripción	Ejemplo
region_id	Busca ciudades que pertenezcan a una región específica	https://www.centry.cl/conexion/v1/locations/cities.json?region_id=5769714df82f456e80000001
name	Busca ciudades por el nombre el nombre exacto	https://www.centry.cl/conexion/v1/locations/cities.json?name=Santiago

Obtener una ciudad específica

Este endpoint entrega una ciudad específica.

curl "https://www.centry.cl/conexion/v1/locations/cities/<city_id>.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5769714df82f456e80000001",
    "region_id": "5769714df82f456e80000000",
    "created_at": "2016-06-21T12:54:37.370-04:00",
    "name": "Región Metropolitana",
    "position": 1,
    "updated_at": "2016-06-21T12:54:37.370-04:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
city_id	El identificador de la ciudad a recuperar

Communes

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador de la comuna sólo lectura
name	string	Nombre de la comuna en Centry sólo lectura
city_id	string	Identificador de la ciudad a la que pertenece la comuna sólo lectura
created_at	string	Fecha de creación de la comuna en Centry sólo lectura
updated_at	string	Fecha de la última actualización sólo lectura

Todas las comunas

Este endpoint entrega todas las comunas de Centry.

curl "https://www.centry.cl/conexion/v1/locations/communes.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5769714df82f456e80000048",
        "city_id": "5769714df82f456e80000011",
        "created_at": "2016-06-21T12:54:37.449-04:00",
        "name": "Pozo Almonte",
        "region_id": "5769714df82f456e80000002",
        "updated_at": "2016-06-21T12:54:37.449-04:00"
    },
    {
        "_id": "5769714df82f456e8000004c",
        "city_id": "5769714df82f456e80000011",
        "created_at": "2016-06-21T12:54:37.453-04:00",
        "name": "Pica",
        "region_id": "5769714df82f456e80000002",
        "updated_at": "2016-06-21T12:54:37.453-04:00"
    },
    {
        "_id": "5769714df82f456e8000004b",
        "city_id": "5769714df82f456e80000011",
        "created_at": "2016-06-21T12:54:37.452-04:00",
        "name": "Huara",
        "region_id": "5769714df82f456e80000002",
        "updated_at": "2016-06-21T12:54:37.452-04:00"
    }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/locations/communes.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación.

Filtros especiales

Solo pueden ser ocupados para este endpoint en particular.

Filtro	Descripción	Ejemplo
city_id	Busca comunas que pertenezcan a una ciudad específica	https://www.centry.cl/conexion/v1/locations/communes.json?city_id=5769714df82f456e80000011
name	Busca comunas por el nombre el nombre exacto	https://www.centry.cl/conexion/v1/locations/communes.json?name=Pica

Obtener una comuna específica

Este endpoint entrega una comuna específica.

curl "https://www.centry.cl/conexion/v1/locations/communes/<commune_id>.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5769714df82f456e80000001",
    "region_id": "5769714df82f456e80000000",
    "created_at": "2016-06-21T12:54:37.370-04:00",
    "name": "Región Metropolitana",
    "position": 1,
    "updated_at": "2016-06-21T12:54:37.370-04:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
commune_id	El identificador de la comuna a recuperar

Orders

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador de orden sólo lectura
_status	string	Estado de la orden. Las opciones son pending, shipped, received, cancelled, cancelled_before_shipping o cancelled_after_shipping.
status_origin	string	Etiqueta con el estado del pedido según la plataforma de origen.
address_billing	object	Dirección de facturación. Ver Formulario de direcciones
address_shipping	object	Dirección de despacho. Ver Formulario de direcciones
buyer_dni	string	Número de identificación nacional del cliente (ej. en Chile es el RUN)
buyer_email	string	Email de Cliente
buyer_first_name	string	Nombre de Cliente
buyer_last_name	string	Apellido de Cliente
buyer_phone	string	Número de teléfono (preferentemente fijo)
buyer_mobilephone	string	Número de teléfono (preferentemente móvil)
buyer_birthdate	string	Fecha de nacimiento del cliente.
_buyer_gender	string	Género del comprador. Las opciones son undefined, male, female u `other.
_payment_mode	string	Tipo de pago empleado por el comprador. Las opciones son undefined, cash, credit_card, debit_card o transfer.
items	array	Lista de ítems a comprar. Ver Atributos de los ítems
origin	string	Origen de donde fue importada la orden
original_data	string	Es un JSON codificado como string con toda la información tal cual como viene en la plataforma de origen
id_origin	string	Identificador del pedido en la plataforma de Origen
number_origin	string	Número del pedido con el que se maneja la orden en la plataforma de origen
id_pack	string	Identificador de paquete asociado al pedido
url_origin	string	URL desde la cual puede ser accedida la orden en la plataforma de origen
total_amount	float	Monto total de los productos comprados
shipping_amount	float	Costo del despacho del pedido
discount_amount	float	Suma total de los descuentos aplicados a los productos del pedido
paid_amount [^1]	float	Monto total pagado por el cliente. En un caso ideal es igual a total_amount + shipping_amount - discount_amount
date_for_delivery	date-time	Fecha estimada en la que se espera despachar el pedido
date_for_reception	date-time	Fecha estimada en la que se espera que el cliente reciba el pedido
received_date	date-time	Fecha en el que el cliente recibe la orden
shipped_date	date-time	Fecha en el que se despacha la orden
cancelled_date	date-time	Fecha en que la orden fue anulada
billable	boolean	Indica si el pedido deber ser facturado por el seller (true) o no (false).
invoice_required	boolean	Indica si el pedido requiere una factura (true) o no (false).
modify_stock	boolean	Indica si el registro del pedido modificó el stock (true) o no (false).
own_shipment	boolean	Indica si el pedido debe ser despachado con una flota propia del seller (true) o no (false).
fraud_risk_detected	boolean	Indica el el marketplace ha detectado que podría ser un fraude (true) o no (false).
priority_shipping	boolean	Indica si el pedido debe ser despachado con prioridad (true) o no (false).
company_id	string	Identificador de la empresa sólo lectura
created_at	date-time	Fecha de creación de la orden en Centry sólo lectura
updated_at	date-time	Fecha de la ultima actualización a la orden en Centry sólo lectura
created_at_origin	date-time	Fecha de creación de la orden en la plataforma de origen sólo lectura
updated_at_origin	date-time	Fecha de la ultima actualización a la orden en la plataforma de origen sólo lectura

[^1]: Si el atributo paid_amount tiene un valor, quiere decir que el pedido está pagado total o parcialmente.

Formulario de direcciones

Estos datos pueden variar y son consistentes para los parámetros address_billing y address_shipping

Este recurso almacena tanto información de una dirección como de una persona de contacto asociada a esta locación.

Atributo	Tipo	Descripción
_id	string	Identificador de formulario sólo lectura
email	string	Email de la persona de contacto
first_name	string	Nombre(s) de la persona de contacto
last_name	string	Apellido(s) de la persona de contacto
phone1	string	Numero telefónico principal
phone2	string	Número telefónico alternativo
line1	string	Dirección principal. Ej: “Aurelio González 3838”
line2	string	Complemento de la línea 1. Ej: “Oficina 02”
zip_code	string	Código postal. Ej: “7630354”
county	string	Nombre de la comuna. Ej “Vitacura”
city	string	Nombre de la ciudad. Ej “Santiago”
state	string	Estado o región. Ej: “Región Metropolitana”
country	string	Nombre del país. Ej: “Chile”
created_at	string	Fecha de la realización del formulario sólo lectura
updated_at	date-time	Fecha de actualización de formulario sólo lectura

Atributos de los ítems

Atributo	Tipo	Descripción
_id	string	Identificador de conjunto de ítems sólo lectura
id_origin	string	Identificador de la línea en la plataforma de origen
sku	string	SKU del producto involucrado según lo informado por la plataforma de origen
name	string	Nombre del producto
unit_price	float	Precio unitario
paid_price	float	Monto pagado
tax_amount	float	Cantidad de impuesto
discount_amount	float	Descuentos aplicado al producto
shipping_amount	float	Costo del despacho
currency	string	Tipo de moneda en el que se paga
quantity	integer	Número de unidades solicitadas originalmente
quantity_restocked	integer	Unidades repuestas
shipment_provider	string	Empresa encargada del despacho
shipping_type	string	Tipo de despacho
tracking_code	string	Código de seguimiento
tracking_code_pre	string
tracking_url	string	URL con información del seguimiento del despacho
variant_id	integer	Identificador de variante registrada en Centry
created_at	date-time	Fecha de creación de este elemento sólo lectura
updated_at	date-time	Fecha de actualización sólo lectura

Todas las órdenes de la cuenta

Este endpoint entrega todas las ordenes de la cuenta.

curl "https://www.centry.cl/conexion/v1/orders.json"/
 -H "Authorization: Bearer  <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
  {
        "_buyer_gender": "undefined",
        "_id": "57bf36a08b5bc7a24920c8b4",
        "_payment_mode": "undefined",
        "_status": "received",
        "address_billing": {
            "_id": "57bf3610915bc7a23920c8ba",
            "city": "",
            "country": "Chile",
            "county": null,
            "created_at": null,
            "email": null,
            "first_name": "Cliente genérico",
            "last_name": null,
            "line1": "",
            "line2": "",
            "phone1": "",
            "phone2": "",
            "state": "",
            "updated_at": null,
            "zip_code": ""
        },
        "address_shipping": {
            "_id": "57bf3610925bc7a23920c8ba",
            "city": "",
            "country": "Chile",
            "county": null,
            "created_at": null,
            "email": null,
            "first_name": null,
            "last_name": null,
            "line1": "",
            "line2": null,
            "phone1": null,
            "phone2": null,
            "state": "",
            "updated_at": null,
            "zip_code": ""
        },
        "buyer_birthdate": null,
        "buyer_dni": null,
        "buyer_email": null,
        "buyer_first_name": "Cliente genérico",
        "buyer_last_name": null,
        "buyer_mobilephone": null,
        "buyer_phone": null,
        "cancelled_date": null,
        "company_id": "501f5000000588f5b5ef82f4",
        "created_at": "2018-10-17T17:57:29.888-03:00",
        "date_for_delivery": null,
        "date_for_reception": null,
        "discount_amount": null,
        "id_origin": "4234",
        "id_woocommerce": null,
        "integrations": {},
        "items": [
            {
                "_id": "5bc7a23920c8ba57bf36108c",
                "created_at": null,
                "currency": null,
                "discount_amount": null,
                "id_origin": null,
                "name": "Carcasa para celular Tamaño Único, Multicolor",
                "paid_price": null,
                "quantity": 1,
                "quantity_restocked": null,
                "shipment_provider": null,
                "shipping_amount": null,
                "shipping_type": null,
                "sku": null,
                "tax_amount": null,
                "tracking_code": null,
                "tracking_code_pre": null,
                "tracking_url": null,
                "unit_price": 2900,
                "updated_at": null,
                "variant_id": "5942afc1f82f4566c60000a2"
            }
        ],
        "number_origin": null,
        "origin": "relBase",
        "original_data": null,
        "paid_amount": 2900,
        "received_date": null,
        "shipment_label": null,
        "shipped_date": null,
        "shipping_amount": 0,
        "status_origin": null,
        "tax_amount": null,
        "total_amount": 2900,
        "updated_at": "2018-10-17T17:57:29.888-03:00",
        "url_origin": "http://app.relbase.cl/dtes/boletas/10000"
    },
    {
        "_buyer_gender": "undefined",
        "_id": "096ef853335bc7e6df20c8ba",
        "_payment_mode": "undefined",
        "_status": "received",
        "address_billing": {
            "_id": "5017ec39705bcc2fb820c8ba",
            "city": "Vitacura",
            "country": "CL",
            "county": null,
            "created_at": "2018-10-21T04:50:16.456-03:00",
            "email": null,
            "first_name": "John",
            "last_name": "Doe",
            "line1": "Aurelio González",
            "line2": "Of 02",
            "phone1": "+56232716362",
            "phone2": null,
            "state": "REG.METROPOLITANA",
            "updated_at": "2018-10-21T04:50:16.456-03:00",
            "zip_code": null
        },
        "address_shipping": {
            "_id": "5017ec39715bcc2fb820c8ba",
            "city": "Vitacura",
            "country": "CL",
            "county": null,
            "created_at": "2018-10-21T04:50:16.456-03:00",
            "email": null,
            "first_name": "John",
            "last_name": "Doe",
            "line1": "Aurelio González",
            "line2": "Of 02",
            "phone1": "+56232716362",
            "phone2": null,
            "state": "REG.METROPOLITANA",
            "updated_at": "2018-10-21T04:50:16.456-03:00",
            "zip_code": null
        },
        "buyer_birthdate": null,
        "buyer_dni": "19",
        "buyer_email": null,
        "buyer_first_name": "John",
        "buyer_last_name": "Doe",
        "buyer_mobilephone": null,
        "buyer_phone": null,
        "cancelled_date": null,
        "company_id": "588f5b5ef82f4501f5000000",
        "created_at": "2018-10-17T22:50:23.515-03:00",
        "date_for_delivery": null,
        "date_for_reception": null,
        "discount_amount": 0,
        "id_origin": "47304624-J",
        "integrations": {},
        "items": [
            {
                "_id": "5017ec398c5bcc2fb920c8ba",
                "created_at": "2018-10-21T04:50:17.862-03:00",
                "currency": null,
                "discount_amount": null,
                "id_origin": "80417610",
                "name": "POSA VASOS | Talla Unica | Negro  PVS1001",
                "paid_price": 16860,
                "quantity": 3,
                "quantity_restocked": null,
                "shipment_provider": "DHL e-Commerce",
                "shipping_amount": 3990,
                "shipping_type": null,
                "sku": null,
                "tax_amount": null,
                "tracking_code": "5118102013583578",
                "tracking_code_pre": null,
                "tracking_url": null,
                "unit_price": 12870,
                "updated_at": "2018-10-21T04:50:17.862-03:00",
                "variant_id": "5a69de14f82f45596a000224"
            }
        ],
        "number_origin": null,
        "origin": "Ripley",
        "original_data": "{\"acceptance_decision_date\":\"2018-10-17T19:49:45Z\",\"can_cancel\":false,\"channel\":null,\"commercial_id\":\"...\"}",
        "paid_amount": 16860,
        "received_date": null,
        "shipment_label": null,
        "shipped_date": null,
        "shipping_amount": 3990,
        "status_origin": "RECEIVED",
        "tax_amount": null,
        "total_amount": 12870,
        "updated_at": "2018-10-19T17:00:27.770-03:00",
        "url_origin": null
    }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/orders.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación. Además, de ser necesario algunos filtros pueden ser concatenados de la forma https://www.centry.cl/conexion/v1/orders.json?<filter>=<valor>&<filter>=<valor>&…

Filtros especiales

Solo pueden ser ocupados para este endpoint en particular.

Filtro	Descripción	Ejemplo
status	Corresponde al estado del pedido, sus posibles valores pueden ser: pending, shipped, received, cancelled, cancelled_before_shipping, cancelled_after_shipping	https://www.centry.cl/conexion/v1/orders.json?status=received
origin	Corresponde al origen del pedido, por ejemplo: Ripley, MercadoLibre, Dafiti, etc.	https://www.centry.cl/conexion/v1/orders.json?origin=Ripley
expand	Sirve para incluir la información completa de las variantes en los items del pedido	https://www.centry.cl/conexion/v1/orders.json?status=pending&expand
id_origin	Filtra los resultados en base al identificador de origen	https://www.centry.cl/conexion/v1/orders.json?id_origin=100001
number_origin	Filtra los resultados en base el número del pedido. Es importante tener presente de que no todas las integraciones entregan este dato	https://www.centry.cl/conexion/v1/orders.json?number_origin=5840001

Obtener una orden específica

Este endpoint entrega una orden específica.

curl "https://www.centry.cl/conexion/v1/orders/096ef853335bc7e6df20c8ba.json"/
 -H "Authorization: Bearer  <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_buyer_gender": "undefined",
    "_id": "096ef853335bc7e6df20c8ba",
    "_payment_mode": "undefined",
    "_status": "received",
    "address_billing": {
        "_id": "5017ec39705bcc2fb820c8ba",
        "city": "Vitacura",
        "country": "CL",
        "county": null,
        "created_at": "2018-10-21T04:50:16.456-03:00",
        "email": null,
        "first_name": "John",
        "last_name": "Doe",
        "line1": "Aurelio González",
        "line2": "Of 02",
        "phone1": "+56232716362",
        "phone2": null,
        "state": "REG.METROPOLITANA",
        "updated_at": "2018-10-21T04:50:16.456-03:00",
        "zip_code": null
    },
    "address_shipping": {
        "_id": "5017ec39715bcc2fb820c8ba",
        "city": "Vitacura",
        "country": "CL",
        "county": null,
        "created_at": "2018-10-21T04:50:16.456-03:00",
        "email": null,
        "first_name": "John",
        "last_name": "Doe",
        "line1": "Aurelio González",
        "line2": "Of 02",
        "phone1": "+56232716362",
        "phone2": null,
        "state": "REG.METROPOLITANA",
        "updated_at": "2018-10-21T04:50:16.456-03:00",
        "zip_code": null
    },
    "buyer_birthdate": null,
    "buyer_dni": "19",
    "buyer_email": null,
    "buyer_first_name": "John",
    "buyer_last_name": "Doe",
    "buyer_mobilephone": null,
    "buyer_phone": null,
    "cancelled_date": null,
    "company_id": "588f5b5ef82f4501f5000000",
    "created_at": "2018-10-17T22:50:23.515-03:00",
    "date_for_delivery": null,
    "date_for_reception": null,
    "discount_amount": 0,
    "id_origin": "47304624-J",
    "integrations": {},
    "items": [
        {
            "_id": "5017ec398c5bcc2fb920c8ba",
            "created_at": "2018-10-21T04:50:17.862-03:00",
            "currency": null,
            "discount_amount": null,
            "id_origin": "80417610",
            "name": "POSA VASOS | Talla Unica | Negro  PVS1001",
            "paid_price": 16860,
            "quantity": 3,
            "quantity_restocked": null,
            "shipment_provider": "DHL e-Commerce",
            "shipping_amount": 3990,
            "shipping_type": null,
            "sku": null,
            "tax_amount": null,
            "tracking_code": "5118102013583578",
            "tracking_code_pre": null,
            "tracking_url": null,
            "unit_price": 12870,
            "updated_at": "2018-10-21T04:50:17.862-03:00",
            "variant_id": "5a69de14f82f45596a000224"
        }
    ],
    "number_origin": null,
    "origin": "Ripley",
    "original_data": "{\"acceptance_decision_date\":\"2018-10-17T19:49:45Z\",\"can_cancel\":false,\"channel\":null,\"commercial_id\":\"...\"}",
    "paid_amount": 16860,
    "received_date": null,
    "shipment_label": null,
    "shipped_date": null,
    "shipping_amount": 3990,
    "status_origin": "RECEIVED",
    "tax_amount": null,
    "total_amount": 12870,
    "updated_at": "2018-10-19T17:00:27.770-03:00",
    "url_origin": null
}

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	El identificador de la orden a recuperar

Crear una orden

Este endpoint crea una orden.

curl -X POST https://www.centry.cl/conexion/v1/orders.json \
 -H "Authorization: Bearer <access_token>"\
    -H "Content-Type: application/json" \
    -d '{  
 "address_billing":{
  "city":"Santiago",
  "country":"Chile",
  "email":"Email@Factura.cl",
  "first_name":"Vía cUrl",
  "last_name":"Apellido Factura",
  "line1":"Dirección Cliente",
  "line2":"Dirección alternativa",
  "phone1":"89668063",
  "phone2":"75927583",
  "state":"EstadoFactura",
  "zip_code":"2948513"
  },
 "address_shipping":{
  "city":"Santiago",
  "country":"Chile",
  "email":"Email@Envío.cl",
  "first_name":"Nombre Envío",
  "last_name":"Apellido Envío",
  "line1":"Dirección Cliente",
  "line2":"Dirección alternativa",
  "phone1":"89668063",
  "phone2":"89765482",
  "state":"EstadoFactura",
  "zip_code":"2948513"
  },
 "total_amount": 6950493,
 "buyer_email":"Email@Cliente.cl",
 "buyer_first_name":"Vía cURl",
 "buyer_last_name":"Apellido Cliente",
 "origin":"cUrl app",
 "items":
  [{
   "name":"L, Café",
   "quantity":5,
   "unit_price":19999.0,
   "variant_id":"597906591d41c80b2e000010"
   }]
 }'

HTTP Request

Eliminar una orden

Este endpoint elimina una orden.

curl -X DELETE https://www.centry.cl/conexion/v1/orders/096ef853335bc7e6df20c8ba.json \
    -H "Authorization: Bearer <access_token>" > deleteResponse.json

Lo anterior retorna un JSON estructurado de la siguiente manera:

true

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	El identificador de la Orden a eliminar

Obtener etiquetas de despacho

Este endpoint recibe identificadores de pedidos y retorna un listado de documentos codificados en Base64.

curl "https://www.centry.cl/conexion/v1/orders/shipping_labels.json?ids[]=096ef853335bc7e6df20c8ba"/
 -H "Authorization: Bearer  <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "orders": [
            {
                "_id": "5ccc461a1a61bb184c11d18a",
                "origin": "MercadoLibre",
                "id_origin": "2032305225",
                "extras": {
                    "shipping": {
                        "id": 27895575952
                    }
                }
            }
        ],
        "files": [
            {
                "content_type": "application/pdf",
                "filename": "labels_and_manifest.pdf",
                "content_base_64": "...",
                "confirmation_box_id": "66290d46606d7237e304635d"
            }
        ]
    }
]

HTTP Request

Parámetros URL

Parámetro	Descripción
ids	Es un listado de identificadores de pedidos de Centry

La respuesta entrega un arreglo de objetos estructurados de la siguiente manera:

Llave	Descripción
orders	Un arreglo de objetos con información de los los pedidos involucrados en los documentos adjuntos, esta información es: _id: identificador del pedido en centry, origin: Nombre de la plataforma de desde donde se originó el pedido, id_origin: identificador del pedido en la plataforma de origen, extras información relevante que pudiera servir para cada integración. Este último campo varía de plataforma en plataforma, por ejemplo para mercado libre entrega un objeto shipping con el identificador del despacho, mientras que en Dafiti o Linio entrega un arreglo llamado order_item_ids con los identificadores de las líneas del pedido.
files	un listado de objetos con los documentos asociados, estos objetos están compuesto de 3 campos: content_type el mime type del archivo adjunto, filename un nombre de fantasía que describe el documento, content_base_64 el contenido del documento codificado en base 64, confirmation_box_id el ID del confirmation_box (aparece cuando el pedido se confirma por partes).

Confirmación de un pedido pendiente

Este endpoint permite confirmar que se entregará un pedido pendiente para aquellas integraciones que así lo admiten. Estas integraciones son:

• Falabella Marketplace
• Mercado Libre: división de paquetes

curl "https://www.centry.cl/conexion/v1/orders/5eece46148f039166bf5ffad/order_status/confirmations.json" \
     -H "Authorization: Bearer  <access_token>" \
     -d '{
    "reason_id": "627d45751a61bb7eba979e95", 
    "boxes": [
        {
            "dimensions": {
                "length": 10.0,
                "width": 11.0,
                "height": 12.0,
                "weight": 1.5
            },
            "items": {
                "sku_ejemplo_1": 1,
                "sku_ejemplo_2": 1
            },
            "package_id": "10000"
        }
    ]
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "_id": "5eece7c248f0390feef121c4",
  "boxes": [
    {
      "_id": "5f119e7948f03956a204f3bf",
      "skus": [
        {
          "_id": "5f119e8f48f03956a204f3c0",
          "sku": "sku_ejemplo_1",
          "quantity": 1
        },
        {
          "_id": "5f119e8f48f03956a204f3c1",
          "sku": "sku_ejemplo_2",
          "quantity": 1
        }
      ],
      "l": 10.0,
      "w": 11.0,
      "h": 12.0,
      "e": 1.5,
      "pid": "10000",
      "reason_id": "5e45b03c48f0392442dbd1a6",
    }
  ],
  "order_id": "5eece46148f039166bf5ffad",
  "success_response": {
    any success response
  },
  "failed_attempts": [],
  "created_at": "2020-06-19T08:28:50.880-08:00"
}

Ejemplos de “any success response”:

Para Falabella

{
    "uuid": "e8352482-1acb-4997-9759-cf5f4b3ceb8b",
    "status": "DONE",
    "errors": []
},

Para MercadoLibre

{
    "respose": "empty response"
}

Ejemplos de respuestas de error

El pedido ya fué confirmado/dividido a través de este endpoint:

{
    "error": "Order already confirmed",
    "confirmation": {
        "_id": "6286a6cc606d72463551d771",
        "boxes": [
            {
                "_id": "6286a6cc606d72463551d772",
                "e": 1.5,
                "h": 12.0,
                "l": 10.0,
                "pid": "10000",
                "skus": [
                    {
                        "_id": "6286a6cc606d72463551d773",
                        "sku": "sku_ejemplo_1",
                        "quantity": 1
                    }
                ],
                "w": 11.0
            },
            {
                "_id": "6286a6cc606d72463551d774",
                "e": 1.5,
                "h": 12.0,
                "l": 10.0,
                "pid": "10001",
                "skus": [
                    {
                        "_id": "6286a6cc606d72463551d775",
                        "sku": "sku_ejemplo_2",
                        "quantity": 2
                    }
                ],
                "w": 11.0
            }
        ],
        "order_id": "6286a41f606d72638813ccf5",
        "reason_id": "62617fda606d72ad5f126268",
        "success_response": {
            "respose": "empty response"
        },
        "failed_attempts": [],
        "created_at": "2022-05-19T12:21:32.869-08:00"
    }
}

Las cajas no contienen el total de los ítemes (existe ítemes que quedaron sin caja, o hay más ítemes en cajas que los contenidos en el pedido)

{
    "boxes": [
        "Las cajas deben incluir exactamente todos los ítemes"
    ]
}

(MercadoLibre) El pedido no puede dividirse, por que proviene ya de una división de un pedido padre.

{
    "_id": "628be852606d7224185748f4",
    "boxes": [
        {
            "_id": "628be852606d7224185748f5",
            "e": null,
            "h": null,
            "l": null,
            "pid": "10000",
            "skus": [
                {
                    "_id": "628be852606d7224185748f6",
                    "sku": "sku_ejemplo_1",
                    "quantity": 1
                }
            ],
            "w": null
        },
        {
            "_id": "628be852606d7224185748f6",
            "e": null,
            "h": null,
            "l": null,
            "pid": "10001",
            "skus": [
                {
                    "_id": "628be852606d7224185748f6",
                    "sku": "sku_ejemplo_2",
                    "quantity": 1
                }
            ],
            "w": null
        }
    ],
    "order_id": "6286a77d606d72e6adb19ec2",
    "reason_id": "62617fda606d72ad5f126268",
    "success_response": null,
    "failed_attempts": [
        {
            "timestamp": "2022-05-23T16:02:28-04:00",
            "response": {
                "error": "Shipment 41385645354 has only one item and can't be splitted"
            }
        }
    ],
    "created_at": "2022-05-23T12:02:26.830-08:00"
}

(MercadoLibre) La división de pedidos debe contener exactamente dos cajas (no es posible utilizar más cajas, por limitación de MercadoLibre)

{
    "_id": "628bec7f606d7224185748f8",
    "boxes": [
        {
            "_id": "628bec7f606d7224185748f9",
            "e": null,
            "h": null,
            "l": null,
            "pid": "10000",
            "skus": [
                {
                    "_id": "628bec7f606d7224185748fa",
                    "sku": "sku_ejemplo_1",
                    "quantity": 1
                }
            ],
            "w": null
        },
        {
            "_id": "628bec7f606d7224185748fb",
            "e": null,
            "h": null,
            "l": null,
            "pid": "10001",
            "skus": [
                {
                    "_id": "628bec7f606d7224185748fc",
                    "sku": "sku_ejemplo_2",
                    "quantity": 2
                }
            ],
            "w": null
        },
        {
            "_id": "628bec7f606d7224185748fd",
            "e": null,
            "h": null,
            "l": null,
            "pid": "10002",
            "skus": [
                {
                    "_id": "628bec7f606d7224185748fe",
                    "sku": "sku_ejemplo_2",
                    "quantity": 1
                }
            ],
            "w": null
        }
    ],
    "order_id": "628bec53606d7250f717ad7c",
    "reason_id": "62617fda606d72ad5f126268",
    "success_response": null,
    "failed_attempts": [
        {
            "timestamp": "2022-05-23T16:20:17-04:00",
            "response": {
                "error": "Pack count should be between 2, 2"
            }
        }
    ],
    "created_at": "2022-05-23T12:20:15.727-08:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	Identificador de un pedido en Centry

Body request

Parámetro	Descripción
reason_id	Identificador del motivo por el cual el pedido se requiere esta división. Sólo MercadoLibre admite este atributo y es obligatorio. ConfirmationReasons
boxes	Listado de cajas, paquetes o bultos que componen el pedido.
boxes.dimensions	Diccionario con las longitudes y peso del bulto. Sólo Falabella admite este diccionario.
boxes.dimensions.length	Largo del bulto medido en centímetros.
boxes.dimensions.width	Ancho del bulto medido en centímetros.
boxes.dimensions.height	Alto del bulto medido en centímetros.
boxes.dimensions.weight	Peso del bulto medido en kilogramos.
boxes.package_id	Código para identificar la caja. Sólo MercadoLibre admite este atributo y es opcional.
boxes.items	Diccionario con el listado de todos los productos que componen el bulto. Cada llave es el SKU del producto y los valores son las unidades de cada SKU

Body response

Parámetro	Descripción
_id	Identificador de la confirmación en Centry
order_id	Identificador del pedido asociado a esta confirmación
boxes	Listado de cajas, paquetes o bultos que componen el pedido
success_response	Diccionario con la respuesta entregada por la plataforma de origen del pedido. No existe un formato predefinido para este campo, depende de cada integración y puede cambiar sin previo aviso. Lo más relevante es que su presencia indica que la confirmación ha resultado exitosa.
failed_attempts	Listado con todos los intentos fallidos que ha tenido esta confirmación en la plataforma de origen del pedido.
created_at	fecha de creación de la confirmación

Reagendamiento de un pedido pendiente

Este endpoint permite reagendar un pedido pendiente para aquellas integraciones que así lo admiten. Estas integraciones son:

• Falabella Marketplace

curl "https://www.centry.cl/conexion/v1/orders/5eece46148f039166bf5ffad/order_status/reschedules.json" \
     -H "Authorization: Bearer  <access_token>" \
     -d '{
    "date": "2021-02-31"
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "_id": "5eeba37348f03925389e5a20",
  "order_id": "5eeba0ad48f039354aa785ac",
  "success_response": {
    "uuid": "0f2ca23b-10be-4237-bf03-74f521fb1ee8",
    "status": "DONE",
    "errors": []
  },
  "failed_attempts": [],
  "created_at": "2020-06-18T09:25:07.451-08:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	Identificador de un pedido en Centry

Body request

Parámetro	Descripción
date	Nueva fecha con la que se quiere reagendar el pedido.

Body response

Parámetro	Descripción
_id	Identificador del reagendamiento en Centry
order_id	Identificador del pedido asociado a este reagendamiento
date	Fecha solicitada para reagendar
success_response	Diccionario con la respuesta entregada por la plataforma de origen del pedido. No existe un formato predefinido para este campo, depende de cada integración y puede cambiar sin previo aviso. Lo más relevante es que su presencia indica que el reagendamiento ha resultado exitoso.
failed_attempts	Listado con todos los intentos fallidos que ha tenido este reagendamiento en la plataforma de origen del pedido.
created_at	fecha de creación del reagendamiento

Anulación de un pedido pendiente

Este endpoint permite anular un pedido pendiente para aquellas integraciones que así lo admiten. Estas integraciones son:

• Falabella Marketplace
• Mercado Libre
• Dafiti
• Linio
• Shopify

curl "https://www.centry.cl/conexion/v1/orders/5eece46148f039166bf5ffad/order_status/cancellations.json" \
     -H "Authorization: Bearer  <access_token>" \
     -d '{
    "buyer_rate_id": "5e45b03d48f0392442dbd1bc",
    "reason_id": "5e45b03c48f0392442dbd1a6",
    "message": "Solicitud del cliente",
    "restock": true
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "_id": "5eeba37348f03925389e5a20",
  "buyer_rate_id": "5e45b03d48f0392442dbd1bc",
  "order_id": "5eeba0ad48f039354aa785ac",
  "reason_id": "5e45b03c48f0392442dbd1a6",
  "message": "Solicitud del cliente",
  "restock": true,
  "success_response": {
    "uuid": "0f2ca23b-10be-4237-bf03-74f521fb1ee8",
    "status": "DONE",
    "errors": []
  },
  "failed_attempts": [],
  "created_at": "2020-06-18T09:25:07.451-08:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	Identificador de un pedido en Centry

Body request

Parámetro	Descripción
buyer_rate_id	Identificado de la calificación del comprador BuyerRates
reason_id	Identificador del motivo de anulación CancellationReasons
message	Texto con la justificación de la anulación del pedido
restock	Boolean que indica si se requiere reponer (true) o no (false) el stock. Está opción se puede usar dependiendo de si lo admite el motivo de anulación

Body response

Parámetro	Descripción
_id	Identificador de la anulación en Centry
order_id	Identificador del pedido asociado a esta anulación
buyer_rate_id	Identificado de la calificación del comprador
reason_id	Identificador del motivo de anulación
message	Texto con la justificación de la anulación del pedido
restock	Boolean que indica si se requiere reponer (true) o no (false) el stock.
success_response	Diccionario con la respuesta entregada por la plataforma de origen del pedido. No existe un formato predefinido para este campo, depende de cada integración y puede cambiar sin previo aviso. Lo más relevante es que su presencia indica que la anulación ha resultado exitosa.
failed_attempts	Listado con todos los intentos fallidos que ha tenido esta anulación en la plataforma de origen del pedido.
created_at	fecha de creación de la anulación

Confirmación de entrega de un pedido pendiente

Este endpoint permite confirmar la entrega de un pedido pendiente para aquellas integraciones que así lo admiten. Estas integraciones son:

• Mercado Libre

curl "https://www.centry.cl/conexion/v1/orders/5eece46148f039166bf5ffad/order_status/delivery_confirmations.json" \
     -H "Authorization: Bearer  <access_token>" \
     -d '{
    "buyer_rate_id": "5e45b03d48f0392442dbd1bc",
    "message": "Solicitud del cliente"
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "_id": "5eeba37348f03925389e5a20",
  "buyer_rate_id": "5e45b03d48f0392442dbd1bc",
  "order_id": "5eeba0ad48f039354aa785ac",
  "message": "Solicitud del cliente",
  "success_response": {
     "reason": null,
     "reply_status": null,
     "date_created": "2020-10-07T13:34:29.601-04:00",
     "fulfilled": true,
     "rating": "NEUTRAL",
     "visibility_date": null,
     "message": "Solicitud del cliente",
     "cust_role": "seller",
     "site_id": "MLC",
     "id": 9041211809440,
     "cust_from": 526176909,
     "reply": null,
     "cust_to": 628867579,
     "order_id": 4083462417,
     "status": "hidden",
     "reply_date": null
  },
  "failed_attempts": [],
  "created_at": "2020-06-18T09:25:07.451-08:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	Identificador de un pedido en Centry

Body request

Parámetro	Descripción
buyer_rate_id	Identificado de la calificación del comprador BuyerRates
message	Texto con la justificación de la confirmación de entrega del pedido

Body response

Parámetro	Descripción
_id	Identificador de la confirmación de entrega en Centry
order_id	Identificador del pedido asociado a esta confirmación de entrega
buyer_rate_id	Identificado de la calificación del comprador
message	Texto con la justificación de la confirmación de entrega del pedido
success_response	Diccionario con la respuesta entregada por la plataforma de origen del pedido. No existe un formato predefinido para este campo, depende de cada integración y puede cambiar sin previo aviso. Lo más relevante es que su presencia indica que la confirmación de entrega ha resultado exitosa.
failed_attempts	Listado con todos los intentos fallidos que ha tenido esta confirmación de entrega en la plataforma de origen del pedido.
created_at	fecha de creación de la confirmación de entrega

Todas las notas de un pedido

Este endpoint permite obtener todas las notas de pedido de un pedido en particular:

curl -L -X GET 'https://www.centry.cl/conexion/v1/orders/<order_id>/order_notes.json' \
-H 'Authorization: Bearer <access_token>'

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "6035671984c6e1147fa0dca2",
        "created_at": "2021-02-23T17:35:37.060-03:00",
        "order_id": "602bd13084c6e18fca85b820",
        "text": "Nota pedido 4",
        "updated_at": "2021-02-23T17:35:37.060-03:00",
        "user_id": "5fd0e51784c6e117832602cd"
    },
    {
        "_id": "6035665784c6e111b4d19f49",
        "created_at": "2021-02-23T17:32:23.935-03:00",
        "order_id": "602bd13084c6e18fca85b820",
        "text": "Nota pedido 3",
        "updated_at": "2021-02-23T17:32:23.935-03:00",
        "user_id": "5fd0e51784c6e117832602cd"
    },
    {
        "_id": "603565e184c6e111b4d19f44",
        "created_at": "2021-02-23T17:30:25.049-03:00",
        "order_id": "602bd13084c6e18fca85b820",
        "text": "Nota pedido 2",
        "updated_at": "2021-02-23T17:30:25.049-03:00",
        "user_id": "5fd0e51784c6e117832602cd"
    },
    {
        "_id": "603565d784c6e111b4d19f41",
        "created_at": "2021-02-23T17:30:15.074-03:00",
        "order_id": "602bd13084c6e18fca85b820",
        "text": "Nota pedido 1",
        "updated_at": "2021-02-23T17:30:15.074-03:00",
        "user_id": "5fd0e51784c6e117832602cd"
    }
]

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	Identificador de un pedido en Centry

Body response

Parámetro	Descripción
_id	Identificador de la nota del pedido
order_id	Identificador del pedido asociado a esta nota de pedido
user_id	Identificador del usuario que realizó la nota de pedido Asignado de manera automática
text	Texto correspondiente a la nota de pedido

Crear una nota de pedido

Este endpoint permite crear una nota de pedido para un pedido en particular:

curl -L -X POST 'https://www.centry.cl/conexion/v1/orders/<order_id>/order_notes.json' \
-H 'Authorization: Bearer <access_token>' \
-H 'Content-Type: application/json' \
--data-raw '{
    "text": "Nota pedido 5"
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "603567f384c6e1147fa0dcad",
        "created_at": "2021-02-23T17:39:15.279-03:00",
        "order_id": "602bd13084c6e18fca85b820",
        "text": "Nota pedido 5",
        "updated_at": "2021-02-23T17:39:15.279-03:00",
        "user_id": "5fd0e51784c6e117832602cd"
    },
    {
        "_id": "6035671984c6e1147fa0dca2",
        "created_at": "2021-02-23T17:35:37.060-03:00",
        "order_id": "602bd13084c6e18fca85b820",
        "text": "Nota pedido 4",
        "updated_at": "2021-02-23T17:35:37.060-03:00",
        "user_id": "5fd0e51784c6e117832602cd"
    },
    {
        "_id": "6035665784c6e111b4d19f49",
        "created_at": "2021-02-23T17:32:23.935-03:00",
        "order_id": "602bd13084c6e18fca85b820",
        "text": "Nota pedido 3",
        "updated_at": "2021-02-23T17:32:23.935-03:00",
        "user_id": "5fd0e51784c6e117832602cd"
    },
    {
        "_id": "603565e184c6e111b4d19f44",
        "created_at": "2021-02-23T17:30:25.049-03:00",
        "order_id": "602bd13084c6e18fca85b820",
        "text": "Nota pedido 2",
        "updated_at": "2021-02-23T17:30:25.049-03:00",
        "user_id": "5fd0e51784c6e117832602cd"
    },
    {
        "_id": "603565d784c6e111b4d19f41",
        "created_at": "2021-02-23T17:30:15.074-03:00",
        "order_id": "602bd13084c6e18fca85b820",
        "text": "Nota pedido 1",
        "updated_at": "2021-02-23T17:30:15.074-03:00",
        "user_id": "5fd0e51784c6e117832602cd"
    }
]

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	Identificador de un pedido en Centry

Body request

Parámetro	Descripción
text	Texto correspondiente a la nota del pedido

Body response

Parámetro	Descripción
_id	Identificador de la nota del pedido
order_id	Identificador del pedido asociado a esta nota de pedido
user_id	Identificador del usuario que realizó la nota de pedido Asignado de manera automática
text	Texto correspondiente a la nota de pedido

Todos los documentos de un pedido

Este endpoint permite obtener todos los documentos de un pedido en particular:

curl -L -X GET 'https://www.centry.cl/conexion/v1/orders/<order_id>/documents.json' \
-H 'Authorization: Bearer <access_token>'

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_document_type": "invoice",
        "number": "800566",
        "_id": "6052202e84c6e19ccecb1966",
        "c_at": "2021-03-17T12:28:46.171-03:00",
        "file_content_type": "application/pdf",
        "file_file_name": "nombre_archivo.pdf",
        "file_file_size": 35517,
        "file_fingerprint": "f69fd4473948e0bb7aa8e0d71610e1a5",
        "file_updated_at": "2021-03-17T10:32:24.412-03:00",
        "order_id": "6048df5184c6e187a31a6200",
        "confirmation_box_id": null
    },
    {
        "_document_type": "invoice",
        "number": "",
        "_id": "6052203884c6e19ccecb1968",
        "c_at": "2021-03-17T12:28:56.384-03:00",
        "file_content_type": "application/pdf",
        "file_file_name": "nombre_archivo.pdf",
        "file_file_size": 82419,
        "file_fingerprint": "f69fd4473948e0bb7aa8e0d71610e1a5",
        "file_updated_at": "2021-03-17T10:28:56.307-03:00",
        "order_id": "6048df5184c6e187a31a6200",
        "confirmation_box_id": "6048df5184c6e187a31b5673"
    }
]

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	Identificador de un pedido en Centry

Body response

Parámetro	Descripción
_id	Identificador de la nota del pedido
order_id	Identificador del pedido asociado a esta nota de pedido
file_file_name	Nombre del archivo del documento
_document_type	Tipo de documento: [bill invoice credit_note debit_note shipping_guide other]
file_file_size	Tamaño del archivo en KB
number	Número de folio del documento (Opcional)
confirmation_box_id	Identificador de un bulto en caso de que el pedido haya sido confirmado parcialmente (Opcional)

Mostrar un documento de un pedido

Este endpoint permite obtener un documento específico de un pedido en particular:

curl -L -X GET 'https://www.centry.cl/conexion/v1/orders/<order_id>/documents/<document_id>.json' \
-H 'Authorization: Bearer <access_token>'

Lo anterior retorna un JSON estructurado de la siguiente manera:

  {
      "_document_type": "invoice",
      "number": "800566",
      "_id": "6052203884c6e19ccecb1968",
      "c_at": "2021-03-17T12:28:56.384-03:00",
      "file_content_type": "application/pdf",
      "file_file_name": "nombre_archivo.pdf",
      "file_file_size": 82419,
      "file_fingerprint": "f69fd4473948e0bb7aa8e0d71610e1a5",
      "file_updated_at": "2021-03-17T10:28:56.307-03:00",
      "order_id": "6048df5184c6e187a31a6200",
      "confirmation_box_id": "6048df5184c6e187a31b5673"
  }

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	Identificador de un pedido en Centry
document_id	Identificador de un documento en Centry

Body response

Parámetro	Descripción
_id	Identificador de la nota del pedido
order_id	Identificador del pedido asociado a esta nota de pedido
file_file_name	Nombre del archivo del documento
_document_type	Tipo de documento: [bill invoice credit_note debit_note shipping_guide other]
file_file_size	Tamaño del archivo en KB
number	Número de folio del documento (Opcional)
confirmation_box_id	Identificador de un bulto en caso de que el pedido haya sido confirmado parcialmente (Opcional)

Crear un documento de un pedido

Este endpoint cargar un documento y asociarlo a un pedido en particular:

curl -L -X POST 'www.centry.cl/conexion/v1/orders/<order_id>/documents.json' \
-H 'Authorization: Bearer  <access_token>' \
-F 'document_type=invoice' \
-F 'file=@/Users/nameuser/Documents/nombre_archivo.pdf'
-F 'number=800566'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_document_type": "invoice",
    "number": "800566",
    "_id": "6052203884c6e19ccecb1968",
    "c_at": "2021-03-17T12:28:56.384-03:00",
    "file_content_type": "application/pdf",
    "file_file_name": "nombre_archivo.pdf",
    "file_file_size": 82419,
    "file_fingerprint": "f69fd4473948e0bb7aa8e0d71610e1a5",
    "file_updated_at": "2021-03-17T10:28:56.307-03:00",
    "order_id": "6048df5184c6e187a31a6200",
    "confirmation_box": null
}

Mismo ejemplo anterior, pero ahora indicando un confirmation_box_id:

curl -L -X POST 'www.centry.cl/conexion/v1/orders/<order_id>/documents.json' \
-H 'Authorization: Bearer  <access_token>' \
-F 'document_type=invoice' \
-F 'file=@/Users/nameuser/Documents/nombre_archivo.pdf'
-F 'number=800566'
-F 'confirmation_box_id=6048df5184c6e187a31b5673'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_document_type": "invoice",
    "number": "800566",
    "_id": "6052203884c6e19ccecb1968",
    "c_at": "2021-03-17T12:28:56.384-03:00",
    "file_content_type": "application/pdf",
    "file_file_name": "nombre_archivo.pdf",
    "file_file_size": 82419,
    "file_fingerprint": "f69fd4473948e0bb7aa8e0d71610e1a5",
    "file_updated_at": "2021-03-17T10:28:56.307-03:00",
    "order_id": "6048df5184c6e187a31a6200",
    "confirmation_box": "6048df5184c6e187a31b5673"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	Identificador de un pedido en Centry

Body form-data

Parámetro	Descripción	Tipo
file	Archivo del documento a anexar al pedido	File
document_type	Tipo de documento: [bill, invoice, credit_note, debit_note, shipping_guide, other]	Text
number	Número de folio del documento (Opcional)	Text
confirmation_box_id	Identificador de un bulto en caso de que el pedido haya sido confirmado parcialmente (Opcional)	Text

Body response

Parámetro	Descripción
_id	Identificador de la nota del pedido
order_id	Identificador del pedido asociado a esta nota de pedido
file_file_name	Nombre del archivo del documento
_document_type	Tipo de documento: [bill invoice credit_note debit_note shipping_guide other]
file_file_size	Tamaño del archivo en KB
number	Número de folio del documento (Opcional)
confirmation_box_id	Identificador de un bulto en caso de que el pedido haya sido confirmado parcialmente (Opcional)

Eliminar un documento de un pedido

Este endpoint permite eliminar un documento específico de un pedido en particular:

curl -L -X DELETE 'https://www.centry.cl/conexion/v1/orders/<order_id>/documents/<document_id>.json' \
-H 'Authorization: Bearer <access_token>'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "message": "Document deleted"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
order_id	Identificador de un pedido en Centry
document_id	Identificador de un documento en Centry

Body response

Parámetro	Descripción
message	Mensaje de respuesta del servidor

ConfirmationReasons

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador del motivo de la confirmación/división de pedido sólo lectura
name	string	Nombre del motivo de la confirmación/división en Centry sólo lectura
description	string	Texto que describe con mayor detalle cada item sólo lectura

Todos los motivos de confirmación/división

Este endpoint entrega todos los motivos de confirmación/división de Centry.

curl "https://www.centry.cl/conexion/v1/confirmation_reasons.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5e4d26431a61bb54b678a145",
        "name": "Frágil",
        "description": "Productos frágiles."
    },
    {
        "_id": "5e4d26431a61bb54b678a14c",
        "name": "Otro centro de distribución",
        "description": "Los productos tienen que ser despachados desde distintos orígenes."
    },
    {
        "_id": "5e4d26431a61bb54b678a153",
        "name": "Forma irregular",
        "description": "La forma de los productos impide enviarlos en un mismo paquete."
    },
    {
        "_id": "5e4d26431a61bb54b678a154",
        "name": "Dimensiones excedidas",
        "description": "Los productos no caben todos en un mismo bulto."
    },
    {
        "_id": "5e4d26431a61bb54b678a155",
        "name": "Otro motivo",
        "description": "Existen otros motivos por los cuales no todos los productos pueden ir en un mismo bulto."
    }
]

HTTP Request

Obtener un motivo de confirmación/división específico

Este endpoint entrega un motivo de confirmación/división específico.

curl "https://www.centry.cl/conexion/v1/confirmation_reasons/5e4d26431a61bb54b678a145.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5e4d26431a61bb54b678a145",
    "name": "Frágil",
    "description": "Productos frágiles."
}

HTTP Request

Parámetros URL

Parámetro	Descripción
confirmation_reason_id	El identificador del motivo de la confirmación/división a recuperar

BuyerRates

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador de la calificación del comprador sólo lectura
name	string	Nombre de la calificación del comprador en Centry sólo lectura
description	string	Texto que describe con mayor detalle cada item sólo lectura

Todas las calificaciones de comprador

Este endpoint entrega todas las calificaciones de comprador de Centry.

curl "https://www.centry.cl/conexion/v1/buyer_rates.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un Jcalificación del compradorSON estructurado de la siguiente manera:

[
    {
        "_id": "5e4d26431a61bb54b678a15b",
        "name": "Neutra",
        "description": "No es posible calificar al comprador o es indiferente"
    },
    {
        "_id": "5e4d26431a61bb54b678a15d",
        "name": "Negativa",
        "description": "No es un un buen comprador."
    }
]

HTTP Request

Obtener una calificación de comprador específica

Este endpoint entrega una calificación de comprador específica.

curl "https://www.centry.cl/conexion/v1/buyer_rates/5e4d26431a61bb54b678a15b.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "_id": "5e4d26431a61bb54b678a15b",
  "name": "Neutra",
  "description": "No es posible calificar al comprador o es indiferente"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
buyer_rate_id	El identificador de la calificación del comprador a recuperar

CancellationReasons

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador del motivo de la cancelación sólo lectura
name	string	Nombre del motivo de la cancelación en Centry sólo lectura
description	string	Texto que describe con mayor detalle cada item sólo lectura

Todos los motivos de cancelación

Este endpoint entrega todos los motivos de cancelación de Centry.

curl "https://www.centry.cl/conexion/v1/cancellation_reasons.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5e4d26431a61bb54b678a145",
        "_restock": "not_allowed",
        "name": "Sin stock",
        "description": "El producto se encuentra agotado."
    },
    {
        "_id": "5e4d26431a61bb54b678a14c",
        "_restock": "optional",
        "name": "Solicitud del cliente",
        "description": "Es el compardor el que ha decidido anular la compra"
    },
    {
        "_id": "5e4d26431a61bb54b678a153",
        "_restock": "optional",
        "name": "Demora en la entrega",
        "description": "Se ha retrasado en forma excesiva el despacho del pedido"
    }
]

HTTP Request

Obtener un motivo de cancelación específico

Este endpoint entrega un motivo de cancelación específico.

curl "https://www.centry.cl/conexion/v1/cancellation_reasons/5e4d26431a61bb54b678a145.json"/
 -H "Authorization: Bearer <access_token>"

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
  "_id": "5e4d26431a61bb54b678a145",
  "_restock": "not_allowed",
  "name": "Sin stock",
  "description": "El producto se encuentra agotado."
}

HTTP Request

Parámetros URL

Parámetro	Descripción
cancellation_reason_id	El identificador del motivo de la cancelación a recuperar

Integration Configs

La API de Centry permite listar, ver, y eliminar integraciones a marketplaces y/o ecommerces individualmente.

Las integraciones pueden ser administradas desde la plataforma web de Centry o parcialmente usando los endpoints de la API REST.

Parámetros

Parámetros comunes a todas las integraciones

Atributo	Tipo	Descripción
_id	string	Identificador de la integración sólo lectura
_delete_status	string	Sólo admite los valores unpublish y delete y definen el comportamiento de la publicación del producto después de que se elimine de Centry: unpublish lo pausa o despublica, mientras que delete lo intenta eliminar permanentemente.
_use	string	Sólo admite los valores slave y master y definen quién es el cargado de llevar el control del catálogo e inventario: Centry (slave) o la integración (master). Sólo algunas integraciones admiten el modo master.
target	string	Indica el tipo de integración a la que pertenece (Ej: Dafiti, Linio MercadoLibre, etc.)
name	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
description	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
shortdescription	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
price_compare	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
price	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
price_factor	float	Factor por el cual se multiplicarán los precios para esta integración.
price_round	int	Número al cual se aproximarán los precios.
stock_discount	int	Numero de unidades por variantes que se dejarán de publicar para esta integración.
condition	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
package_dimensions	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
package_weight	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
warranty	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
barcode	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
sku	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
sku_prefix	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
images	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
images	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
category	boolean	Flag que indica si Centry enviará este campo cada vez que se sincronicen productos con esta integración.
excluded_brand_ids	array	Listado de marcas que serán excluidas de la la sincronización de productos para esta integración.
excluded_category_ids	array	Listado de categorías que serán excluidas de la la sincronización de productos para esta integración.
excluded_product_ids	array	Listado de producto que serán excluidas de la la sincronización de productos para esta integración.
enabled	boolean	Flag que indica si esta integración está disponible. sólo lectura
company_id	string	Identificador de empresa sólo lectura
created_at	string	Fecha de creación de la integración en Centry sólo lectura
updated_at	string	Fecha de la última modificación de la integración en Centry sólo lectura

Parámetros específicos para cada integración

Atributo	Tipo	Integraciones	Descripción

Listar las integraciones de la cuenta

Este endpoint entrega todas las integraciones registradas en la cuenta.

curl -X GET \
  https://www.centry.cl/conexion/v1/integration_configs.json \
  -H 'authorization: Bearer <access_token>' \

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
  {
      "_delete_status": "unpublish",
      "_id": "59d295351746bf7fa9000003",
      "_use": "slave",
      "api_key": "linio_api_key",
      "barcode": true,
      "category": true,
      "company_id": "59355c1b1746bf25a8000000",
      "condition": true,
      "created_at": "2017-10-02T16:36:21.588-03:00",
      "description": true,
      "enabled": true,
      "excluded_brand_ids": [
          "580450f61746bf79030001eb",
          "59baccbf133b5a34d452a33c"
      ],
      "excluded_category_ids": [
          "580450f61746bf79030001a7"
      ],
      "excluded_product_ids": [
          "59d242ae1746bf33f4000000"
      ],
      "images": true,
      "name": true,
      "package_dimensions": true,
      "package_weight": true,
      "price": true,
      "price_compare": true,
      "price_factor": 1,
      "price_round": 0,
      "shortdescription": true,
      "sku": true,
      "sku_prefix": "",
      "stock_discount": 0,
      "target": "Linio",
      "updated_at": "2017-10-02T16:37:00.426-03:00",
      "username": "linio_usuario",
      "warranty": true
  }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/integration_configs.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación. Además, de ser necesario algunos filtros pueden ser concatenados de la forma https://www.centry.cl/conexion/v1/integration_configs.json?<filter>=<valor>&<filter>=<valor>&…

Obtener una integración específica

Este endpoint entrega una integración específica.

curl -X GET \
  https://www.centry.cl/conexion/v1/integration_configs/59d295351746bf7fa9000003.json \
  -H 'authorization: Bearer <access_token>' \

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_delete_status": "unpublish",
    "_id": "59d295351746bf7fa9000003",
    "_use": "slave",
    "api_key": "linio_api_key",
    "barcode": true,
    "category": true,
    "company_id": "59355c1b1746bf25a8000000",
    "condition": true,
    "created_at": "2017-10-02T16:36:21.588-03:00",
    "description": true,
    "enabled": true,
    "excluded_brand_ids": [
        "580450f61746bf79030001eb",
        "59baccbf133b5a34d452a33c"
    ],
    "excluded_category_ids": [
        "580450f61746bf79030001a7"
    ],
    "excluded_product_ids": [
        "59d242ae1746bf33f4000000"
    ],
    "images": true,
    "name": true,
    "package_dimensions": true,
    "package_weight": true,
    "price": true,
    "price_compare": true,
    "price_factor": 1,
    "price_round": 0,
    "shortdescription": true,
    "sku": true,
    "sku_prefix": "",
    "stock_discount": 0,
    "target": "Linio",
    "updated_at": "2017-10-02T16:37:00.426-03:00",
    "username": "linio_usuario",
    "warranty": true
}

HTTP Request

Parámetros URL

Parámetro	Descripción
ic_id	El identificador de la integración a recuperar

Eliminar una integración

Este endpoint elimina permanentemente una integración específica.

curl -X DELETE \
  https://www.centry.cl/conexion/v1/integration_configs/59d295351746bf7fa9000003.json \
  -H 'authorization: Bearer <access_token>'

Lo anterior retorna un JSON estructurado de la siguiente manera:

true

HTTP Request

Parámetros URL

Parámetro	Descripción
ic_id	El identificador de la integración a eliminar

Warehouse Priority

Las configuraciones de integraciones usan este recurso para determina de cuáles bodegas se tomará el stock a la hora de sincronizar las cantidades disponibles de productos y variantes. Por otro lado, cuando se registra una venta de ésta integración, se útiliza este recurso para determinar de cuáles bodegas se debe hacer el descuento de stock.

En definitiva los Warehouse Priorities son un listado ordenado de bodegas con los cuales se trabajara con una integración en particular.

Opcionalmente, los Warehouse Priorities pueden tener una referencia a una sucursal o bodega si la integración de permite. Esto tiene dos útilidades:

1. Permite actualizar stock de productos y variantes directo a una bodega específica de la integración.
2. Si desde el origen viene un pedido asociado a una bodega, por ejemplo en una compra con retiro en tienda, entonces Centry respeta esa relación y usa ese criterio a la hora de hacer el descuento de stock y no usa el criterio de prioridades explicados en los párrafos anteriores

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador del recurso sólo lectura
priority	integer	Prioridad de la bodega en la integración, donde 0 es la prioridad más alta y va decayendo en la medida que este número crece sólo lectura
location_id	string	Identificador de la sucursal o bodega de destino en caso de que la integración lo permita sólo lectura
integration_config_id	string	Identificado de IntegrationConfig al que está asociado sólo lectura
warehouse_id	string	Identificado de Warehouse al que está asociado sólo lectura
c_at	string	Registro de creación en Centry sólo lectura
u_at	string	Registro de última actualización sólo lectura

Todos los Warehouse Priorities

Este endpoint entrega todos los Warehouse Priorities de un Integration Config

curl "https://www.centry.cl/conexion/v1/integration_configs/5b042c94f82f45124d0681bd/warehouse_priorities.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "5daf12011a61bb3434b4ddfb",
        "c_at": "2019-10-22T11:28:17.180-03:00",
        "deleted_at": null,
        "integration_config_id": "5b042c94f82f45124d0681bd",
        "location_id": null,
        "priority": 0,
        "u_at": "2019-10-22T11:28:17.180-03:00",
        "warehouse_id": "577eb7b8f82f456ef4000001"
    },
    {
        "_id": "611e8dc0b291750ba5654110",
        "c_at": "2021-08-19T12:58:40.234-04:00",
        "deleted_at": null,
        "integration_config_id": "5b042c94f82f45124d0681bd",
        "location_id": null,
        "priority": 1,
        "u_at": "2021-08-19T12:58:40.234-04:00",
        "warehouse_id": "5db064b421b3eb70da09551d"
    },
    {
        "_id": "611e8dc0b291750ba5654111",
        "c_at": "2021-08-19T12:58:40.248-04:00",
        "deleted_at": null,
        "integration_config_id": "5b042c94f82f45124d0681bd",
        "location_id": null,
        "priority": 2,
        "u_at": "2021-08-19T12:58:40.248-04:00",
        "warehouse_id": "5db064fabc46c0578f83ae4e"
    }
]

HTTP Request

Parámetros URL

Parámetro	Descripción
integration_config_id	El identificador de la configuración de integración

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/integration_config/<integration_config_id>/warehouse_priorities.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación. Además, de ser necesario algunos filtros pueden ser concatenados de la forma https://www.centry.cl/conexion/v1/integration_config/<integration_config_id>/warehouse_priorities.json?<filter>=<valor>&<filter>=<valor>&…

Obtener un Warehouse Priority específico

Este endpoint entrega un Warehouse Priority específico

curl "https://www.centry.cl/conexion/v1/integration_configs/5b042c94f82f45124d0681bd/warehouse_priorities/5daf12011a61bb3434b4ddfb.json"/
 -H "Authorization: Bearer  <access_token> "

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "5daf12011a61bb3434b4ddfb",
    "c_at": "2019-10-22T11:28:17.180-03:00",
    "deleted_at": null,
    "integration_config_id": "5b042c94f82f45124d0681bd",
    "location_id": null,
    "priority": 0,
    "u_at": "2019-10-22T11:28:17.180-03:00",
    "warehouse_id": "577eb7b8f82f456ef4000001"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
integration_config_id	El identificador de la configuración de integración
warehouse_priority_id	El identificador del WarehousePriority

Companies

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador de la empresa
_keywords
address	string	Dirección de la empresa
bio	string	Biografía de la empresa
created_at	date-time	Fecha de creación
logo_content_type	string
logo_file_name	string	Nombre del archivo del logo
logo_file_size	string	Tamaño del archivo del logo
logo_fingerprint	string
logo_updated_at	date-time	Fecha de actualización del logo
main_warehouse_id	string
name	string	Nombre de la empresa
sector	string	Sector de la empresa
social_facebook	string	Página social de Facebook de la empresa
social_instagram	string	Página social de Instagram de la empresa
social_linkedin	string	Página social de LinkedIn de la empresa
social_pinterest	string	Página social de Pinterest de la empresa
social_twitter	string	Página social de Twitter de la empresa
updated_at	date-time	Fecha de actualización
url	string	Página de la empresa
users_count	integer

Obtener información de la empresa

Este endpoint entrega los detalles de la empresa

curl -X GET https://www.centry.cl/conexion/v1/company_info.json \
  -H 'Authorization: Bearer <access_token>' \

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
  {
    "_id": "5c2d1ae68f26c638ca60dc02",
    "_keywords": [],
    "address": "Dirección",
    "bio": "Ecommerce",
    "created_at": "2019-01-02T17:11:18.687-03:00",
    "logo_content_type": null,
    "logo_file_name": null,
    "logo_file_size": null,
    "logo_fingerprint": null,
    "logo_updated_at": null,
    "main_warehouse_id": "5c2d1ae68f26c638ca60dc03",
    "name": "Empresa Normie",
    "sector": null,
    "social_facebook": "fb.com/empresa",
    "social_instagram": "ig.com/empresa",
    "social_linkedin": "lkin.com/empresa",
    "social_pinterest": "ptrst.com/empresa",
    "social_twitter": "tw.com/empresa",
    "updated_at": "2019-01-02T17:11:18.709-03:00",
    "url": "www.empresa_genérica_1.cl",
    "users_count": 4
}
]

HTTP Request

Users

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador del usuario
address	string	Dirección del usuario
address_cont	string
avatar_content_type	string
avatar_file_name	string	Nombre del archivo avatar
avatar_file_size	string	Tamaño del archivo avatar
avatar_fingerprint	string
avatar_updated_at	date-time	Fecha de actualización del avatar
bio	string	Biografía
birthday	string	Fecha de nacimiento
commune_id	string
company_api_id	string	Identificador de la API de la empresa
company_id	string	Identificador de la empresa
company_ids
created_at	date-time	Fecha de creación
email	string	Email del usuario
first_name	string	Primer nombre del usuario
gender	string	Género del usuario
job_title	string	Título de trabajo
last_name	string	Apellido
phone	string	Número de celular
region_id	string	Identificador de la región
role	interger
roles_mask	interger
rut	string	RUT del usuario
show_wizard	boolean
status	interger
telephone	string	Número de Teléfono
updated_at	date-time	Fecha de actualización
user_group_id	string

Obtener información del usuario

Este endpoint entrega los detalles del usuario

curl -X GET https://www.centry.cl/conexion/v1/user_info.json \
  -H 'Authorization: Bearer <access_token>' \

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
  {
    "_id": "5c2d1ae68f26c638ca60dc04",
    "address": "Dirección",
    "address_cont": null,
    "avatar_content_type": null,
    "avatar_file_name": null,
    "avatar_file_size": null,
    "avatar_fingerprint": null,
    "avatar_updated_at": null,
    "bio": "Biografía",
    "birthday": "1/1/1990",
    "commune_id": null,
    "company_api_id": null,
    "company_id": "5c2d1ae68f26c638ca60dc02",
    "company_ids": [],
    "created_at": "2019-01-02T17:11:18.696-03:00",
    "email": "nombre@correo.cl",
    "first_name": "Nombre",
    "gender": "Undefined",
    "job_title": "Trabajo genérico",
    "last_name": "Apellido",
    "phone": "6666666",
    "region_id": null,
    "role": 1,
    "roles_mask": 0,
    "rut": null,
    "show_wizard": false,
    "status": 1,
    "telephone": null,
    "updated_at": "2019-01-02T17:14:03.997-03:00",
    "user_group_id": null
}
]

HTTP Request

Webhooks

La API de Centry permite crear, ver, actualizar y eliminar webhooks individualmente.

Los webhooks pueden ser administrados desde la plataforma web de Centry o usando los endpoints de la API REST.

Todos los webhooks tienen los siguientes datos:

• topic: determina cuál evento de recurso gatilla la notificación.

Mientras que, por los siguientes tópicos, contiene la siguiente información:

• on_product_save ó on_product_delete
  • product_id: Identificador del producto involucrado en el evento.
• on_order_save ó on_order_delete
  • order_id: Identificador de la orden involucrada en el evento.
• on_integration_config_delete ó on_integration_config_save
  • integration_config_id: Identificador de la integración involucrada en el evento.

Topics

El tópico es una combinación entre un recurso (ej. order) y un evento (ej. delete), esto se traduce a un nombre de hook (ej. on_order_delete).

Los tópicos base de Centry son:

• Orders: on_order_save y on_order_delete.
• Products: on_product_save, on_product_delete.
• Integration Configs: on_integration_config_delete, on_integration_config_save.

Entrega e insistencias

La entrega es realizada por Centry inmediatamente después de que ocurre el evento usando él método POST de HTTP.

Centry espera que el receptor de la notificación responda con un código 200 en menos de 15 segundos, de lo contrario volverá a insistir 5 minutos más tarde. Estas insistencias pueden perdurar hasta 48 horas, donde finalmente se desiste de notificar el evento.

El contenido de la notificación está codificado en un JSON e incluye el mínimo de información posible de modo que el receptor tenga consultar a Centry por los datos que necesite.

{
  "topic":"on_product_save",
  "product_id":"59c285f81746bf2096000001"
}

Logging

Las solicitudes de notificaciones y sus respuestas son registradas en un log que contiene los siguientes datos:

• callback_url: URL configurada en el webhook al momento de realizar la notificación
• intent: Número correlativo al numero de intento partiendo siempre desde el 1 y pudiendo terminar en el 576
• response: El contenido de la respuesta. Se guarda cómo como referencia porque no se usa para nada.
• accepted: Un booblean que indica si la notificación fue recibida correctamente o no.
• topic: El tópico involucrado en la notificación.
• data: El contenido completo que fue enviado en la notificación.

Interfáz visual

La administración de los webhooks así como el sus registros del log pueden ser accedidos directamente desde la plataforma web de Centry.

Parámetros

Atributo	Tipo	Descripción
_id	string	Identificador del webhook sólo lectura
callback_url	string	URL a la cual se le enviarán las notificaciones
on_product_save	boolean	Flag que indica si se requiere recibir notificaciones del tipo “actualización de producto”
on_product_delete	boolean	Flag que indica si se requiere recibir notificaciones del tipo “eliminación de producto”
on_order_save	boolean	Flag que indica si se requiere recibir notificaciones del tipo “actualización de pedido”
on_order_delete	boolean	Flag que indica si se requiere recibir notificaciones del tipo “eliminación de pedido”
on_integration_config_save	boolean	Flag que indica si se requiere recibir notificaciones del tipo “actualización de integración”
on_integration_config_delete	boolean	Flag que indica si se requiere recibir notificaciones del tipo “eliminación de integración”
company_id	string	Identificador de empresa sólo lectura
created_at	string	Fecha de creación del webhook en Centry sólo lectura
updated_at	string	Fecha de la última modificación del webhook en Centry sólo lectura

Listar los webhooks de la cuenta

Este endpoint entrega todos los webhooks registrados en la cuenta.

curl -X GET \
  https://www.centry.cl/conexion/v1/webhooks.json \
  -H 'authorization: Bearer <access_token>' \

Lo anterior retorna un JSON estructurado de la siguiente manera:

[
    {
        "_id": "59c427f71746bf5a70000005",
        "callback_url": "http://mi-aplicacion.com/CentryWebhookTest/index.php",
        "company_id": "59355c1b1746bf25a8000000",
        "created_at": "2017-09-21T17:58:31.494-03:00",
        "on_order_delete": true,
        "on_order_save": true,
        "on_product_delete": true,
        "on_product_save": true,
        "on_integration_config_delete": true,
        "on_integration_config_save": false,
        "updated_at": "2017-09-22T11:10:18.174-03:00"
    }
]

HTTP Request

Filtros comunes

Si se desean obtener resultados más específicos para este endpoint, se puede precisar la request agregando parámetros a la URL de la forma https://www.centry.cl/conexion/v1/webhooks.json?<filter>=<valor> como se muestra en el capítulo Filters al final de la documentación. Además, de ser necesario algunos filtros pueden ser concatenados de la forma https://www.centry.cl/conexion/v1/webhooks.json?<filter>=<valor>&<filter>=<valor>&…

Obtener un webhook específico

Este endpoint entrega un webhook específico.

curl -X GET \
  https://www.centry.cl/conexion/v1/webhooks/59c427f71746bf5a70000005.json \
  -H 'authorization: Bearer <access_token>' \

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "59c427f71746bf5a70000005",
    "callback_url": "http://mi-aplicacion.com/CentryWebhookTest/index.php",
    "company_id": "59355c1b1746bf25a8000000",
    "created_at": "2017-09-21T17:58:31.494-03:00",
    "on_order_delete": true,
    "on_order_save": true,
    "on_product_delete": true,
    "on_product_save": true,
    "on_integration_config_delete": true,
    "on_integration_config_save": false,
    "updated_at": "2017-09-22T11:10:18.174-03:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
webhook_id	El identificador del webhook a recuperar

Crear un webhook

Este endpoint permite crear webhook nuevo.

curl -X POST \
  https://www.centry.cl/conexion/v1/webhooks.json \
  -H 'authorization: Bearer <access_token>' \
  -H 'content-type: application/json' \
  -d '{
    "callback_url": "http://192.168.0.1/CentryWebhookTest/index.phps",
    "on_order_delete": true,
    "on_product_save": false
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "59c9852d1746bf1d93000001",
    "callback_url": "http://192.168.0.1/CentryWebhookTest/index.phps",
    "company_id": "59355c1b1746bf25a8000000",
    "created_at": "2017-09-25T19:37:33.016-03:00",
    "on_order_delete": true,
    "on_order_save": false,
    "on_product_delete": false,
    "on_product_save": false,
    "on_integration_config_delete": true,
    "on_integration_config_save": false,
    "updated_at": "2017-09-25T19:37:33.016-03:00"
}

HTTP Request

Actualizar un webhook

Este endpoint permite modificar un webhook específico.

curl -X PUT \
  https://www.centry.cl/conexion/v1/webhooks/59c9852d1746bf1d93000001.json \
  -H 'authorization: Bearer <access_token>' \
  -H 'content-type: application/json' \
  -d '{
    "callback_url": "http://localhost/CentryWebhookTest/index.phps",
    "on_product_save": true
}'

Lo anterior retorna un JSON estructurado de la siguiente manera:

{
    "_id": "59c9852d1746bf1d93000001",
    "callback_url": "http://localhost/CentryWebhookTest/index.phps",
    "company_id": "59355c1b1746bf25a8000000",
    "created_at": "2017-09-25T19:37:33.016-03:00",
    "on_order_delete": true,
    "on_order_save": false,
    "on_product_delete": false,
    "on_product_save": true,
    "on_integration_config_delete": true,
    "on_integration_config_save": false,
    "updated_at": "2017-09-25T19:41:16.604-03:00"
}

HTTP Request

Parámetros URL

Parámetro	Descripción
webhook_id	El identificador del webhook a actualizar

Eliminar un webhook

Este endpoint elimina permanentemente un webhook específico.

curl -X DELETE \
  https://www.centry.cl/conexion/v1/webhooks/59c9852d1746bf1d93000001.json \
  -H 'authorization: Bearer <access_token>'

Lo anterior retorna un JSON estructurado de la siguiente manera:

true

HTTP Request

Parámetros URL

Parámetro	Descripción
webhook_id	El identificador del webhook a eliminar

Errors

La API de Centry usa los siguientes códigos de errores:

Error Code	Meaning
400	Bad Request – Your request sucks
401	Unauthorized – Your API key is wrong
403	Forbidden – The resource requested is hidden for administrators only
404	Not Found – The specified resource could not be found
405	Method Not Allowed – You tried to access a resource with an invalid method
406	Not Acceptable – You requested a format that isn’t json
410	Gone – The resource requested has been removed from our servers
418	I’m a teapot
429	Too Many Requests – You’re requesting too many resources! Slow down!
500	Internal Server Error – We had a problem with our server. Try again later.
503	Service Unavailable – We’re temporarily offline for maintenance. Please try again later.

Filters

La siguiente tabla contiene parámetros URL útiles al momento de enviar un request GET list, el cual termina en una lista detallada de los datos que se quieren obtener. La utilización de valores previamente conocidos pueden ayudar a los procesos de búsqueda y recopilación de información.

Filtro	Descripción	Ejemplo
created_at	Fecha de creación exactamente igual al valor indicado	https://www.centry.cl/conexion/v1/products.json?created_at=2017-09-13T21:00:00.000-03:00
created_at_gte	Fecha de creación mayor o igual al valor indicado	https://www.centry.cl/conexion/v1/products.json?created_at_gte=2017-09-13T21:00:00.000-03:00
created_at_lte	Fecha de creación menor o igual al valor indicado	https://www.centry.cl/conexion/v1/products.json?created_at_lte=2017-09-13T21:00:00.000-03:00
created_at_gt	Fecha de creación mayor al valor indicado	https://www.centry.cl/conexion/v1/products.json?created_at_gt=2017-09-13T21:00:00.000-03:00
created_at_lt	Fecha de creación menor al valor indicado	https://www.centry.cl/conexion/v1/products.json?created_at_lt=2017-09-13T21:00:00.000-03:00
updated_at	Fecha de actualización exactamente igual al valor indicado	https://www.centry.cl/conexion/v1/products.json?updated_at=2017-09-13T21:00:00.000-03:00
updated_at_gte	Fecha de actualización mayor o igual al valor indicado	https://www.centry.cl/conexion/v1/products.json?updated_at_gte=2017-09-13T21:00:00.000-03:00
updated_at_lte	Fecha de actualización menor o igual al valor indicado	https://www.centry.cl/conexion/v1/products.json?updated_at_lte=2017-09-13T21:00:00.000-03:00
updated_at_gt	Fecha de actualización mayor al valor indicado	https://www.centry.cl/conexion/v1/products.json?updated_at_gt=2017-09-13T21:00:00.000-03:00
updated_at_lt	Fecha de actualización menor al valor indicado	https://www.centry.cl/conexion/v1/products.json?updated_at_lt=2017-09-13T21:00:00.000-03:00
limit	Cantidad máxima de resultados que debe mostrar	https://www.centry.cl/conexion/v1/products.json?offset=20&limit=30 o https://www.centry.cl/conexion/v1/products.json?limit=20
after	Mostrar los resultados con identificadores mayores que el señalado	https://www.centry.cl/conexion/v1/products.json?limit=20&after=597644781d41c846ea000006 o
offset	Cantidad de resultados que debe saltarse. Prefiera paginar usando after Deprecado	https://www.centry.cl/conexion/v1/products.json?offset=20