CRM 360  - Integración de Productos




REVISIONES


Fecha

Versión

Autor

Descripción

 

1.0Versión Inicial

 

1.15.0Viviana García Igualación Documento a versión actual



CONTENIDO


Acerca del documento

CRM360 es una solución de Napse para analizar la conducta y el comportamiento de compra de sus clientes, promoviendo así, potenciales oportunidades de interés y retención. 

Este manual está destinado a todos los sistemas de punto de venta que se integren con CRM360 mediante el uso de servicio REST o por Archivo.

A continuación, se dará detalle del servicio REST disponible y el de Archivo, destinado a nutrir la base de datos de productos.


Importación de Productos

Mediante API REST 

Este método posee la especificación detallada ante la creación o actualización de productos.

Este servicio permite el envío de hasta 100 datos.


Método REST basado en el formato JSON. Ejemplo:

EndPoint

[POST] https://[dirección-ip]:[puerto]/api/v1/importData/products

POST - REQUEST

HEADER

Elemento

Valor

x-access-token
Token obtenido a través del servicio "Authenticate"

Ejemplo:

x-access-token:  eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJOYXBzZSIsImRhdGEiOnsiX2lkIjoiNjA1ZGQyNTZjZGE0YzhhNzZkODhhNDFiIn0sImlhdCI6MTYyMTQzMTU5OCwiZXhwIjoxNjIxNTE3OTk4fQ.4gxltyla4zKODtM9w0a4-y2_EMtrkIULB9446RSVpKE


BODY

Ejemplo con POSTMAN: Content Type - raw JSON

Elemento

Descripción

Tipo de dato

Requerido

companyCodeCódigo de compañía, provisto para la empresa que contrata el servicio.StringSi
lotNúmero de identificación de loteStringNo
productsListado de ProductosJSONSi


{
      "companyCode":"napse",
      "lot":"100005043",
      "products": [...]
}



Mediante ARCHIVO

Este método posee la especificación detallada ante la creación o actualización de productos.

Este servicio permite el envío de hasta 100 datos.


Método REST basado en el formato JSON. Ejemplo:

EndPoint

[POST] https://[dirección-ip]:[puerto]/api/v1/importData/blob/products


POST - REQUEST

HEADER

Elemento

Valor

x-access-token
Token obtenido a través del servicio "Authenticate"

Ejemplo:

x-access-token:  eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJOYXBzZSIsImRhdGEiOnsiX2lkIjoiNjA1ZGQyNTZjZGE0YzhhNzZkODhhNDFiIn0sImlhdCI6MTYyMTQzMTU5OCwiZXhwIjoxNjIxNTE3OTk4fQ.4gxltyla4zKODtM9w0a4-y2_EMtrkIULB9446RSVpKE


BODY 

Ejemplo con POSTMAN: Content Type - form-data

Elemento

Valor

file                          Filearchivo.json



Especificación del dato Products

#

Campo

Tipo

Descripción

1codeStringCódigo del producto (SKU)
2name

String

Nombre del producto

3descriptionStringDescripción del producto
4
firstBrand
BooleanRefiere a si el producto es Primera Marca. false = No, true =Si.
5unitMeasureStringRefiere a la unidad de medida del producto.
6
categoryCode
StringRefiere al código de la categoría del producto.
7
categoryName

String

Refiere al Nombre de la categoría del producto.
8brandCodeStringRefiere al código de la marca del producto.
9brandNameStringRefiere al Nombre de la marca del producto.


Especificación del dato unitMeasure

#

Campo

Tipo

Descripción

1code

String

Refiere al código de la unidad de medida

2nameStringDescripción de la unidad: Unidad, Peso etc

Ejemplo:

{
        "code": "102",
        "price": 5790,
        "name": "Jean Mesax",
        "description": "Jean Mesax",
        "categoryCode": "IND",
        "categoryName": "Indumenta",
        "firstBrand": true,
        "brandCode": "LEVIS",
        "brandName": "LEVIS"
    },