Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 205 Next »

La API Defontana está organizada en torno a REST. Nuestra API tiene URLs predecibles orientadas a los recursos, acepta cuerpos de solicitud codificados por formulario, devuelve respuestas codificadas por JSON y utiliza códigos de respuesta HTTP, autenticación y verbos estándar.

Puede usar la API Defontana en modo de prueba, que no afecta sus datos productivos ni interactúa con las redes bancarias u otro subsistema funcional. La URL API que usa para ingresar peticiones determinará si la solicitud es en modo en vivo o en modo de prueba.

 Consideraciones Previas
  • El cliente debe existir en el sistema ERP Defontana.

  • El acceso a cada módulo debe ser solicitado a través del área de Post-Venta o al adquirir los servicios del ERP si se trata de un nuevo cliente del sistema.

  • Es recomendable contar con un equipo desarrollador para implementar la integración entre su sistema y el ERP Defontana.

 Glosario y Acronimos

API: Es un conjunto de funciones y procedimientos que cumplen una o muchas funciones con el fin de ser utilizadas por otro software. Las siglas API provienen del inglés Application Programming Interface. En español sería interfaz de programación de aplicaciones. Básicamente, una API ofrece un conjunto de métodos para: consultar, agregar, modificar y eliminar información de un sistema. Estos métodos permiten que otros programas se conecten al sistema y ejecuten sus operaciones según los requerimientos de cada integración particular.

Token de autenticación: En el caso de la API, los tokens de acceso corresponden al estándar de Internet Json Web Token (JWT). Cada token corresponde a una cadena de texto que contiene información encriptada, asociada a una identidad de usuario del sistema. El token de autenticación es obligatorio para poder utilizar cada método del sistema, con excepción de aquellos que permiten su obtención a través de la ruta /Auth.

URL de documentación técnica Swagger: Consiste en una definición y herramienta de testeo de los métodos ofrecidos por la API de Integración, aplicando el estándar swagger. Se encuentra disponible en la siguiente dirección:

https://api.defontana.com/swagger/index.html

Si usted se encuentra en etapa de pruebas o implementación de su integración, se recomienda utilizar la documentación del sitio de pruebas. Esta documentación es igual a la del sitio real, pero apunta a las bases de datos del sitio de replicación del sistema, lo cual permite hacer pruebas evitando cambiar la información de su empresa en el sitio real del ERP:

https://replapi.defontana.com/swagger/index.html

 Acerca de los Ambientes de Pruebas

Los ambientes de prueba mantienen una disponibilidad en los siguientes horarios:

Día

Estado

Inicio

Fin

Lunes

DISPONIBLE

08:00

20:00

Martes

DISPONIBLE

08:00

20:00

Miércoles

DISPONIBLE

08:00

20:00

Jueves

DISPONIBLE

08:00

20:00

Viernes

DISPONIBLE

08:00

20:00

Sábado

NO DISPONIBLE

-

-

Domingo

NO DISPONIBLE

-

-

Así mismo, estos ambientes se actualizan semanalmente para tener la información en línea contra producción, esto quiere decir que los cambios realizados, documentos emitidos, configuraciones, etc. realizadas durante el transcurso de la semana en el ambiente de replicación NO estarán disponibles a la siguiente semana.

Se recomienda que todas las configuraciones sean realizadas en el ambiente productivo, para evitar pérdida de información.

 Resumen de Metodos

Las operaciones ofrecidas por el sistema están separadas en módulos. Cada módulo de la API agrupa métodos para poder realizar operaciones dentro de un módulo de ERP. Los módulos que actualmente se encuentran desarrollados son los siguientes:

  • AUTH

  • ACCOUNTING

  • SALE

  • INVENTORY

  • PURCHASE

  • PURCHASEORDER

  • DISPATCH

  • ORDER

  • PRICING

Auth: agrupa métodos para obtener tokens de acceso. Para poder utilizar los métodos de los demás módulos es obligatorio obtener previamente un token mediante el cual el usuario valida que posee una sesión vigente en el sistema. Cada token obtenido invalida inmediatamente a todos los que hayan sido obtenidos previamente para el mismo usuario. Debido a esto, si se establece un proceso de ejecuciones paralelas en la API (por ejemplo, ingresar varias ventas al mismo tiempo), se debe establecer desde el lado del cliente un mecanismo de centralización de tokens para evitar invalidaciones.

Accounting: agrupa métodos para administrar la contabilidad de las empresas en el ERP.

Sale: agrupa métodos para administrar las ventas, artículos, clientes, etc. de las empresas en el ERP.

Inventory: agrupa métodos para administrar los movimientos de Inventario de las empresas en el ERP.

Purchase: agrupa métodos para administrar los movimientos de compras de las empresas en el ERP.

Purchaseorder: agrupa métodos para administrar las ordenes de compra de las empresas en el ERP.

Dispatch: agrupa métodos para administrar los despachos de las empresas en el ERP.

Order: agrupa métodos para administrar los pedidos de las empresas en el ERP.

Pricing: (pendiente)

Para poder apreciar un listado de los métodos ofrecidos por la API, se recomienda acceder a la documentación swagger de la misma, a través del siguiente enlace:

https://replapi.defontana.com/swagger

En la interfaz disponible en el enlace podemos ver todos los métodos disponibles, junto a sus datos de entrada y de retorno. También podemos simular las llamadas de cada método para realizar pruebas y aprender cómo funciona cada uno.

Contactos

Equipo Comercial

Nombre y Apellido

Opciones

Detalles

Salomón Carmi

Email

scarmi@defontana.com

Equipo Ingeniería

Nombre y Apellido

Opciones

Detalles

Luis Lopez

Skype

Email

live:.cid.caa2fee512fc856c
luislopezv@defontana.com

Ignacio Olivares

Skype

Email

live:iolivares_19
iolivares@defontana.com

Métodos

A continuación se detallan los métodos disponibles en la API Defontana, pero antes un pequeño recordatorio:

HTTP

CRUD

OBSERVACIÓN

GET

Lectura

DISPONIBLE

POST

Creación

DISPONIBLE

PUT

Actualización/Reemplazo

NO DISPONIBLE

PATCH

Actualización/Reemplazo Parcial

NO DISPONIBLE

DELETE

Eliminación

NO DISPONIBLE

AUTH

 Auth

Obtiene el token de autenticación de un usuario en particular, mediante las “credenciales tradicionales” de acceso al sistema.

Ambientes

Verbo HTTP: GET

Parámetros

Campo

Descripción

Requerido

Client

Identificador del cliente

Si

Company

Identificador de la empresa

Si

User

Identificador del usuario

Si

Password

Contraseña del usuario

Si

De retorno, en caso de haber ingresado los datos de acceso en forma correcta, nos aparecerá un mensaje similar al siguiente. El token de acceso vendrá en el campo “access_token”.

Respuesta

De retorno, en caso de haber ingresado los datos de acceso en forma correcta, nos aparecerá un mensaje similar al siguiente. El token de acceso vendrá en el campo “access_token”

{
  "success": true,
  "message": null,
  "access_token": "eyJ0eXAiOiJLCJh1NiJ9.ey...iZiDAwMzAX0.TR39EE6gtrk",
  "expires_in": 378604799,
  "token_type": "bearer"
}

Respuesta

De retorno en caso de haber ingresado los datos de acceso en forma incorrecta, nos aparecerá un mensaje similar al siguiente. El mensaje de error vendrá en el campo “message“ como “Login failed“

{
  "success": false,
  "message": "Login failed"
  "access_token": null,
  "expires_in": 0,
  "token_type": null,
}
 EmailLogin

Obtiene el token de autenticación de un usuario en particular, mediante las credenciales de acceso al sistema a través de correo y contraseña.

Ambientes

Verbo HTTP: GET

Parámetros

Campo

Descripción

Requerido

Email

Email de acceso

Password

Contraseña del email

Client

Campo para indicar el id de cliente con el cual se requiere iniciar sesión (solo requerido si el correo está asociado a más de un cliente en el ERP)

No

Company

Campo para indicar el id de empresa con la cual se requiere iniciar sesión (solo requerido si el correo está asociado a más de una empresa)

No

User

Campo para indicar el usuario con el cual se requiere iniciar sesión (solo requerido si el correo está asociado a clientes de distintos servicios)

No

De retorno, en caso de haber ingresado los datos de acceso en forma correcta y no tener más de una empresa y/o usuarios asociados al correo, nos aparecerá un mensaje similar al siguiente. El token de acceso vendrá en el campo “access_token”.

Respuesta

{
  "success": true,
  "message": null,
  "jumpUsers": [
  {
    "client": "empresas defontana",
    "company": "dfchile",
    "user": "gpuellestorres",
    "service": "international"
  } ],
    "authResult":
    {
      "success": true,
      "message": null,
      "access_token": "eyJ0eXAKV1J9.eyJuWJBRD...jMjYy0fQ.pi3hW7cPBs",
      "expires_in": 378604799,
      "token_type": "bearer"
  }
}

Se puede dar el caso de que nos llegue una respuesta similar a lo siguiente:

{ 
  "success": true, 
  "message": "Debe indicar un cliente/empresa/usuario a utilizar", 
  "jumpUsers": [ 
  { 
    "client": "client1",
    "company": "company1", 
    "user": "user1", 
    "service": "international" 
  }, 
{ 
    "client": "client1",
    "company": "company2", 
    "user": "user2", 
    "service": "international" 
  }, 
{ 
    "client": "client2", 
    "company": "company2", 
    "user": "user1", 
    "service": "pyme" 
  }
]
}

En este tipo de casos debemos ingresar un id de cliente, empresa y/o usuario, para indicar con cuáles deseamos obtener un token. Para el ejemplo anterior, bastaría con indicar el “client2” de id de cliente (ya que no tenemos más de una empresa o usuario asociados a aquel cliente) y el método nos entregaría un token de acceso para la combinación [client2, company2, user1].

 RegainToken

Obtiene un token de acceso a partir de una sesión ya existente

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json“

Autorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Client

Campo para indicar el id de cliente con el cual se requiere iniciar sesión (solo requerido si el correo está asociado a más de un cliente en el ERP)

Company

Campo para indicar el id de empresa con la cual se requiere iniciar sesión (solo requerido si el correo está asociado a más de una empresa)

User

Identificador del usuario

Session

Identificador de la sesión

Respuesta

De retorno, en caso de haber ingresado los datos de acceso en forma correcta, nos aparecerá un mensaje similar al siguiente.

{
  "success": false,
  "message": "Login failed",
  "access_token": null,
  "expires_in": 0,
  "token_type": null
}

Respuesta

De retorno en caso de haber ingresado los datos de acceso en forma incorrecta, nos aparecerá un mensaje similar al siguiente.

{
  "success": false,
  "message": "Login failed",
  "access_token": null,
  "expires_in": 0,
  "token_type": null
}
 Check

Obtiene un chequeo si la sesión aun esta vigente o no

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json“

Autorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(No Aplica)

Respuesta

De retorno, en caso de tener los datos de acceso en forma correcta, nos aparecerá un mensaje similar al siguiente.

{
  "success": true,
  "message": "Sesión válida.",
  "exceptionMessage": null
}

Respuesta

De retorno, en caso de tener los datos de acceso en forma incorrecta, nos aparecerá un mensaje similar al siguiente.

{
  "success": false,
  "message": "Sesión inválida.",
  "exceptionMessage": null
}

COMPANY

 Company

Permite recuperar información de la empresa.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json“

Autorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(No Aplica)

Respuesta

De retorno, en caso de haber ingresado los datos de acceso en forma correcta, nos aparecerá un mensaje similar al siguiente.

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "data": {
    "companyId": "string",
    "name": "string",
    "legalCode": "string",
    "resolutionNumber": 0,
    "resolutionDate": "2023-02-14T14:30:40.280Z",
    "resolutionYear": 0,
    "resolutionMonth": 0,
    "resolutionDay": 0,
    "webSite": "string",
    "email": "string"
  }
}

ECOMMERCE

 GetSaleClientInformation

Permite obtener la información del cliente de una venta generada en el modulo Ecommerce

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json“

Autorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

DocumentType

Tipo de documento

Number

Número de documento

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "legalCode": "string",
  "name": "string",
  "surname": "string",
  "email": "string",
  "address": "string",
  "number": 0,
  "city": "string",
  "district": "string"
}

ACCOUNTING

 GetVoucher

Permite obtener los datos de un comprobante contable

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json“

Autorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

VoucherType

Tipo de comprobante

Number

Número de comprobante

fiscalYear

Año fiscal del comprobante

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "header": {
    "fiscalYear": 2020,
    "voucherType": "EGRESO",
    "voucherTypeName": "EGRESO",
    "isOpening": false,
    "companyId": "dfchile",
    "companyName": "DEFONTANA CHILE SPA.",
    "number": 1,
    "date": "2020-01-02T00:00:00",
    "comment": "Cancelo Nomina Chile FXR 30-12",
    "state": "A",
    "entryUser": "mrus",
    "entryDate": "2020-01-03T11:46:35.05",
    "affectedPlan": 1
},
  "detail": [
    {
      "accountCode": "110602",
      "debit": 19605,
      "credit": 0,
      "secondaryDebit": 0,
      "secondaryCredit": 0,
      "exchangeRate": 0,
      "comment": "Cancelo Rendicion R. Garcia",
      "fileId": "13.176.789-7",
      "documentType": "",
      "documentSeries": "",
      "documentNumber": 0,
      "documentExpirationDate": "1900-01-01T00:00:00",
      "originDocumentData": "",
      "bussinessCenterId": "",
      "classifier1Id": "",
      "classifier2Id": "",
      "movementTypeId": "",
      "movementSeries": "",
      "movementNumber": ""
  },
  ...
  {
      "accountCode": "110103",
      "debit": 0,
      "credit": 616836,
      "secondaryDebit": 0,
      "secondaryCredit": 0,
      "exchangeRate": 0,
      "comment": "Cancelo Nomina Chile FXR 30-12",
      "fileId": "",
      "documentType": "",
      "documentSeries": "",
      "documentNumber": 0,
      "documentExpirationDate": "1900-01-01T00:00:00",
      "originDocumentData": "",
      "bussinessCenterId": "",
      "classifier1Id": "",
      "classifier2Id": "",
      "movementTypeId": "CB",
      "movementSeries": "",
      "movementNumber": ""
    }
  ]
}
 GetVoucherList

Permite obtener los datos de un listado de comprobantes contables

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Autorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

VoucherType

Permite filtrar comprobantes de un único tipo

No

fiscalYear

Permite filtrar los comprobantes por su año fiscal

No

fromDate

Permite filtrar comprobantes según la fecha de cada uno (los comprobantes entregados tendrán una fecha mayor o igual a la ingresada)

No

toDate

Permite filtrar comprobantes según la fecha de cada uno (los comprobantes entregados tendrán una fecha menor o igual a la ingresada)

No

fromEntryDate

Permite filtrar comprobantes según la fecha de ingreso de cada uno (los comprobantes entregados tendrán una fecha menor o igual a la ingresada)

No

toEntryDate

Permite filtrar comprobantes según la fecha de ingreso de cada uno (los comprobantes entregados tendrán una fecha mayor o igual a la ingresada)

No

user

Permite filtrar comprobantes por el usuario que hizo el ingreso del mismo

No

fromNumber

Permite filtrar comprobantes por su número (los comprobantes entregados tendrán un número mayor o igual al ingresado)

No

toNumber

Permite filtrar comprobantes por su número (los comprobantes entregados tendrán un número menor o igual al ingresado)

No

itemsPerPage

Indica cuántos comprobantes se desean obtener por página. Los resultados a obtener siempre vendrán paginados, y se permite como valor máximo 100 comprobantes por página

page

Indica la página a consultar, para obtener la primera página se debe ingresar el valor 0

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "totalItems": 109759,
  "page": 0,
  "itemsPerPage": 10,
  "items": [
    {
      "voucherType": "VENTASELEC",
      "fiscalYear": 2020,
      "date": "2020-05-06T00:00:00",
      "entryDate": "2020-05-06T16:45:39",
      "entryUserName": "Ali Ruiz",
      "number": 35356,
      "voucherTypeName": "VENTAS ELECTRONICAS"
    },
    …
    {
      "voucherType": "VENTASELEC",
      "fiscalYear": 2020,
      "date": "2020-05-06T00:00:00",
      "entryDate": "2020-05-06T12:10:59",
      "entryUserName": "USUARIO ECOMMERCE",
      "number": 35350,
      "voucherTypeName": "VENTAS ELECTRONICAS"
    }
  ]
}
 GetAccountPlan

Permite obtener el plan de cuentas de una empresa del ERP

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(No Aplica)

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "items": [
    {
      "code": "100000",
      "description": "ACTIVO",
      "ifrsRelatedAccountCode": "0100000",
      "ifrsRelatedAccountDescription": "ACTIVO",
      "childs": [
        {
          "code": "110000",
          "description": "ACTIVO CIRCULANTE",
          "ifrsRelatedAccountCode": "0110000",
          "ifrsRelatedAccountDescription": "ACTIVO CIRCULANTE",
          "childs": [
          {
            "code": "110100",
            "description": "Disponible",
            "ifrsRelatedAccountCode": "0110100",
            "ifrsRelatedAccountDescription": "Disponible",
            "childs": [
            {
              "code": "110101",
              "description": "Caja",
              "ifrsRelatedAccountCode": "0110101",
              "ifrsRelatedAccountDescription": "Caja",
              "childs": null
              },
              ...
            {
              "code": "110115",
              "description": "Banco Santander Dolar",
              "ifrsRelatedAccountCode": "0110115",
              "ifrsRelatedAccountDescription": "Banco Santander Dolar",
              "childs": null
            }
            ]
            },
            ...
            ]
            },
            ...
            {
              "code": "400000",
              "description": "PÉRDIDAS",
              "ifrsRelatedAccountCode": "0400000",
              "ifrsRelatedAccountDescription": "PÉRDIDAS",
              "childs": [...]
            },
            ...
        ]
    }
],
"success": true,
"message": null
}
 GetAccountAnalysis

Permite obtener el análisis de una cuenta

Ambientes

Verbo HTTP: POST

Headers

Tipo

Descripción

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

account

Código de la cuenta a consultar

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "usesClassifier2Analysis": false,
  "usesClassifier1Analysis": false,
  "usesReferenceCurrencyAnalysis": true,
  "usesDocumentAnalysis": false,
  "usesFileAnalysis": false,
  "usesBussinessCenterAnalysis": false,
  "usesBankAnalysis": true,
  "success": true,
  "message": ""
}
 InsertVoucher

Permite ingresar un comprobante contable

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

(header) fiscalYear

Año fiscal del comprobante

(header) number

Número a asignar al comprobante. Si el campo automaticFoliation se envía como true, será reemplazado automáticamente por el siguiente número a utilizar para el tipo de comprobante ingresado

(header) voucherType

Id de Tipo de Comprobante

(header) date

Fecha del comprobante

(header) comment

Comentario/glosa del comprobante

(detail) accountCode

Código de cuenta

(detail) debit

Valor debe en la línea de detalle

(detail) credit

Valor haber en la línea de detalle

(detail) secondaryDebit

Valor debe de la moneda secundaria en la línea de detalle

No

(detail) secondaryCredit

Valor debe de la moneda secundaria en la línea de detalle

No

(detail) exchangeRate

Tasa de cambio entre los valores principales y de moneda secundaria

No

(detail) comment

Comentario/glosa de la línea de detalle

(detail) fileId

Id de ficha asignada al comprobante (análisis de ficha)

Depende del análisis

(detail) documentSeries

Serie de documento (análisis de documento)

Depende del análisis

(detail) documentNumber

Número de documento (análisis de documento)

Depende del análisis

(detail) documentExpirationDate

Fecha de expiración de documento (análisis de documento)

Depende del análisis

(detail) bussinessCenterId

Código de centro de negocios (análisis de centro de negocios)

Depende del análisis

(detail) classifier1Id

Código de clasificador 1 (análisis de clasificador 1)

Depende del análisis

(detail) classifier2Id

Código de clasificador 2 (análisis de clasificador 2)

Depende del análisis

(detail) referenceCurrencyId

Id de moneda de referencia, si corresponde

No

(detail) referenceExchangeRate

Tasa de moneda de referencia, si corresponde

No

(detail) movementTypeId

Código de tipo de movimiento (análisis de banco)

Depende del análisis

(detail) movementSeries

Serie de movimiento (análisis de banco)

Depende del análisis

(detail) movementNumber

Número de movimiento (análisis de banco)

Depende del análisis

(detail) accountAmountRate

Monto de movimiento (análisis de banco)

Depende del análisis

(detail) ctaCreditOrDebitAmount

Monto asignado a valor debe o haber de cuenta de banco asociada a cuenta, si corresponde

No

automaticFoliation

Indica si al comprobante se le debe asignar un número automáticamente. Si se envía un valor “false” se ocupará el valor enviado en el campo (header) number

Respuesta

De retorno, en caso de haber ingresado el JSON de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "voucherType": "Egreso",
  "number": 101,
  "fiscalYear": 2020,
  "success": true,
  "message": ""
}
 UpdateVoucher

Permite ingresar un comprobante contable

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

(header) fiscalYear

Año fiscal del comprobante

(header) number

Número a asignar al comprobante. Si el campo automaticFoliation se envía como true, será reemplazado automáticamente por el siguiente número a utilizar para el tipo de comprobante ingresado

(header) voucherType

Id de Tipo de Comprobante

(header) date

Fecha del comprobante

(header) comment

Comentario/glosa del comprobante

(detail) accountCode

Código de cuenta

(detail) debit

Valor debe en la línea de detalle

(detail) credit

Valor haber en la línea de detalle

(detail) secondaryDebit

Valor debe de la moneda secundaria en la línea de detalle

No

(detail) secondaryCredit

Valor debe de la moneda secundaria en la línea de detalle

No

(detail) exchangeRate

Tasa de cambio entre los valores principales y de moneda secundaria

No

(detail) comment

Comentario/glosa de la línea de detalle

(detail) fileId

Id de ficha asignada al comprobante (análisis de ficha)

Depende del análisis

(detail) documentSeries

Serie de documento (análisis de documento)

Depende del análisis

(detail) documentNumber

Número de documento (análisis de documento)

Depende del análisis

(detail) documentExpirationDate

Fecha de expiración de documento (análisis de documento)

Depende del análisis

(detail) bussinessCenterId

Código de centro de negocios (análisis de centro de negocios)

Depende del análisis

(detail) classifier1Id

Código de clasificador 1 (análisis de clasificador 1)

Depende del análisis

(detail) classifier2Id

Código de clasificador 2 (análisis de clasificador 2)

Depende del análisis

(detail) referenceCurrencyId

Id de moneda de referencia, si corresponde

No

(detail) referenceExchangeRate

Tasa de moneda de referencia, si corresponde

No

(detail) movementTypeId

Código de tipo de movimiento (análisis de banco)

Depende del análisis

(detail) movementSeries

Serie de movimiento (análisis de banco)

Depende del análisis

(detail) movementNumber

Número de movimiento (análisis de banco)

Depende del análisis

(detail) accountAmountRate

Monto de movimiento (análisis de banco)

Depende del análisis

(detail) ctaCreditOrDebitAmount

Monto asignado a valor debe o haber de cuenta de banco asociada a cuenta, si corresponde

No

automaticFoliation

Indica si al comprobante se le debe asignar un número automáticamente. Si se envía un valor “false” se ocupará el valor enviado en el campo (header) number

Respuesta

De retorno, en caso de haber ingresado el JSON de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "voucherType": "Egreso",
  "number": 101,
  "fiscalYear": 2020,
  "success": true,
  "message": ""
}
 DeleteVoucher

Permite eliminar un comprobante contable.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

voucherType

Id del tipo del comprobante a eliminar

number

Número del comprobante

fiscalYear

Año fiscal del comprobante

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 GetClassifier1AnalysisItems

Permite obtener las opciones de valores a ingresar para cuentas con análisis de tipo clasificador 1.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

account

Código de cuenta contable para la que se desean consultar las opciones de análisis

filter

Filtro opcional de resultados a obtener. El valor ingresado se busca tanto en códigos de ítems como en sus descripciones

No

Respuesta

{
  "items": [
    {
      "code": "08.713.530-8",
      "descripction": "Hernán Pérez Villaseca"
    },
    {
      "code": "08.715.870-6",
      "descripction": "Brian Herrera Contreras"
    },
    ...
    {
      "code": "Y_Sevilla",
      "descripction": "Yurisa Danisa Sevilla"
    }
],
"success": true,
"message": null
}
 GetClassifier2AnalysisItems

Permite obtener las opciones de valores a ingresar para cuentas con análisis de tipo clasificador 2.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

account

Código de cuenta contable para la que se desean consultar las opciones de análisis

filter

Filtro opcional de resultados a obtener. El valor ingresado se busca tanto en códigos de ítems como en sus descripciones

No

Respuesta

{
  "items": [
    {
      "code": "01",
      "descripction": "FACT 01"
    },
    ...
    {
      "code": "06",
      "descripction": "Tanner Servicios Financieros"
    }
],
"success": true,
"message": null
}
 GetFileAnalysisItem

Permite obtener las opciones de valores a ingresar para cuentas con análisis de tipo Ficha.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

account

Código de cuenta contable para la que se desean consultar las opciones de análisis

filter

Filtro opcional de resultados a obtener. El valor ingresado se busca tanto en códigos de ítems como en sus descripciones

No

Respuesta

{
  "items": [
    {
      "code": "20514876584",
      "descripction": "AND PERU S.A.C."
    },
    ...
    {
      "code": "08.491.435-0",
      "descripction": "CARLOS ZAPATA GARCÉS"
    }
  ],
"success": true,
"message": null
}
 GetBusinessCenterAnalysisItems

Permite obtener las opciones de valores a ingresar para cuentas con análisis de tipo Centro de Negocios.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

account

Código de cuenta contable para la que se desean consultar las opciones de análisis

filter

Filtro opcional de resultados a obtener. El valor ingresado se busca tanto en códigos de ítems como en sus descripciones

No

Respuesta

{
  "items": [
    {
      "code": "DCMADMADM000000",
      "descripction": "ADMINISTRACIÓN"
    },
    {
      "code": "DCMADMFEL000000",
      "descripction": "FINANCIA EN LINEA"
    },
    ...
    {
      "code": "DCMOPESOP000000",
      "descripction": "SOPORTE"
    }
  ],
"success": true,
"message": null
}
 GetDocumentAnalysisItems

Permite obtener las opciones de valores a ingresar para cuentas con análisis de Documento.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

account

Código de cuenta contable para la que se desean consultar las opciones de análisis

filter

Filtro opcional de resultados a obtener. El valor ingresado se busca tanto en códigos de ítems como en sus descripciones

No

Respuesta

{
  "items": [
    {
      "documentSeries": null,
      "documentNumber": null,
      "code": "BLCD",
      "descripction": "BOLETA DE COMPRA DETALLE"
    }, ...
    {
      "documentSeries": null,
      "documentNumber": null,
      "code": "VALE_VISTA",
      "descripction": "VALE VISTA"
    }
  ],
"success": true,
"message": null
}
 GetBankAnalysisItems

Permite obtener las opciones de valores a ingresar para cuentas con análisis de Documento.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

account

Código de cuenta contable para la que se desean consultar las opciones de análisis

amount

Valor que indica el monto que se asignará a la línea de detalle en donde irá la cuenta indicada en account. Si el valor es por ejemplo 100 pesos al debe, ser debe ingresar el valor 100; mientras que, si el valor fuese 100 pesos al haber, se debe ingresar el valor –100.

Respuesta

{
  "numberLenght": 0,
  "items": [
    {
      "usesSeries": false,
      "usesDocumentNumber": true,
      "usesDetraction": false,
      "code": "ABONO",
      "descripction": "ABONO"
    },
    ...
    {
      "usesSeries": false,
      "usesDocumentNumber": true,
      "usesDetraction": false,
      "code": "VALEVISTA",
      "descripction": "VALE VISTA"
    }
  ],
"success": true,
"message": null
}
 CentralizeSale

Permite centralizar o contabilizar una venta

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

DocumentType

Código del Tipo de Documento de Venta

Number

Número de Documento de Venta

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 GetClientCredit

Permite obtener la información crediticia de un cliente

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

LegalCode

Código legal del cliente

Respuesta

{
legalCode: string
limiteMontoMoroso: int
montoCredito: int
saldoPendiente: int
success: bool
message: string
exceptionMessage: string
}
 GetDocumentsToPay

Permite obtener los documentos pendientes de pago para un cliente en particular.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

FileID

Identificador

ItemsPerPage

Documentos por página

PageNumber

Página de búsqueda (inicia en 0)

Respuesta

{
  "totalItems": 0,
  "page": 0,
  "itemsPerPage": 0,
  "success": true,
  "documents": [
    {
      "idTipoDocumento": "string",
      "idCuenta": "string",
      "series": "string",
      "number": 0,
      "bussinessCenter": "string",
      "expirationDate": "2021-11-30T13:26:43.474Z",
      "amount": 0,
      "alphaSeries": "string",
      "alphaNumber": "string",
      "codelect": "string",
      "documentType": "string"
    }
  ]
}
 GetPaymentDocuments

Permite obtener los documentos de pago asociados a un documento de ventas

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

DocumentType

Tipo de documento de ventas

Folio

Folio de documento de ventas

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "totalItems": 0,
  "items": [
    {
      "voucherType": "string",
      "number": 0,
      "fiscalYear": "string",
      "date": "2021-12-07T18:44:50.948Z",
      "entryDate": "2021-12-07T18:44:50.948Z",
      "gloss": "string",
      "coinID": "string",
      "entryUserName": "string"
    }
  ]
}
 GetAccountNumber

Permite consultar por un número de cuenta contable en específico

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

AccountNumber

Identificador de la cuenta contable

Respuesta

{
  "success": true,
  "message": "string",
  "item": {
    "code": "string",
    "description": "string",
    "active": "string",
    "imputable": "string"
  }
}
 GetBusinessCenter

Permite consultar por centro de negocio en especifico

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripión

Requerido

BusinessCenter

Código de centro de negocios por el cual se quiere consultar

Respuesta

{
  "success": true,
  "message": "string",
  "item": {
    "code": "string",
    "description": "string",
    "active": "string",
    "imputable": "string"
  }
}
 GetClassifier1Analysis

Permite obtener las opciones de análisis de clasificadores 1 para una cuenta en forma paginada

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripión

Requerido

Account

Código de cuenta por la cual se quiere consultar

Filter

Texto opcional para filtro de resultados

No

ItemsPerPage

Numero ítems por pagina

Si

PageNumber

Numero de pagina (Inicia siempre en 0)

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "items": [
    {
      "code": "string",
      "descripction": "string"
    }
  ],
  "itemsPerPage": 0,
  "pageNumber": 0,
  "totalItems": 0
}
 GetClassifierItems

Permite obtener el listado de clasificadores

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ClassifierType

Tipo de Clasificador

No

ItemsPerPage

Numero ítems por pagina

Si

PageNumber

Numero de pagina (Inicia siempre en 0)

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "items": [
    {
      "classifierType": "string",
      "classifierInfo": [
        {
          "code": "string",
          "description": "string"
        }
      ]
    }
  ],
  "totalItems": 0,
  "itemsPerPage": 0,
  "pageNumber": 0
}
 GetClassifier2Analysis

Permite obtener las opciones de análisis de clasificador 2 para una cuenta en forma paginada

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Account

Codigo de cuenta por la cual se quiere consultar

Si

Filter

Texto opcional para filtro de resultados

No

ItemsPerPage

Numero de ítems por pagina

Si

PageNumber

Numero de pagina (Comienza siempre en 0)

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "items": [
    {
      "code": "string",
      "descripction": "string"
    }
  ],
  "itemsPerPage": 0,
  "pageNumber": 0,
  "totalItems": 0
}
 GetVoucherPaginated

Permite obtener los datos de un comprobante contable por pagina

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

VoucherType

ID tipo de comprobante

Si

Number

Numero de comprobante

Si

FiscalYear

Año fiscal

Si

ItemsPerPage

Numero de ítems por pagina

Si

PageNumber

Numero de pagina (Comienza siempre en 0)

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "header": {
    "fiscalYear": 0,
    "voucherType": "string",
    "voucherTypeName": "string",
    "isOpening": true,
    "companyId": "string",
    "companyName": "string",
    "number": 0,
    "date": "2023-03-27T20:11:42.775Z",
    "comment": "string",
    "state": "string",
    "entryUser": "string",
    "entryDate": "2023-03-27T20:11:42.775Z",
    "affectedPlan": 0
  },
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "detail": [
    {
      "accountCode": "string",
      "debit": 0,
      "credit": 0,
      "secondaryDebit": 0,
      "secondaryCredit": 0,
      "exchangeRate": 0,
      "comment": "string",
      "fileId": "string",
      "documentType": "string",
      "documentSeries": "string",
      "documentNumber": 0,
      "documentExpirationDate": "2023-03-27T20:11:42.776Z",
      "originDocumentData": "string",
      "bussinessCenterId": "string",
      "classifier1Id": "string",
      "classifier2Id": "string",
      "movementTypeId": "string",
      "movementSeries": "string",
      "movementNumber": "string"
    }
  ]
}
 GetClientCondition

Permite obtener la condición financiera de un cliente

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

FileID

ID del cliente

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "useClientFinancialCondition": "string",
  "state": "string"
}
 GetPurchaseDocumentsToPay

Permite obtener el listado de los documentos de compras pendientes de pago para un cliente

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

FileID

ID del cliente

Si

ItemsPerPage

Numero de ítems por pagina

Si

Page

Numero de pagina (Comienza siempre en 0)

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "totalItems": 0,
  "page": 0,
  "itemsPerPage": 0,
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "documents": [
    {
      "idTipoDocumento": "string",
      "idCuenta": "string",
      "series": "string",
      "number": 0,
      "bussinessCenter": "string",
      "expirationDate": "2023-03-27T20:42:34.818Z",
      "amount": 0,
      "alphaSeries": "string",
      "alphaNumber": "string",
      "codelect": "string",
      "documentType": "string"
    }
  ]
}
 GetPaidDocuments

Permite obtener el listado de los documentos pagados por un cliente

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

FileID

ID del cliente

Si

ItemsPerPage

Numero de ítems por pagina

Si

Page

Numero de pagina (Comienza siempre en 0)

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "totalItems": 0,
  "page": 0,
  "itemsPerPage": 0,
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "documents": [
    {
      "idTipoDocumento": "string",
      "idCuenta": "string",
      "series": "string",
      "number": 0,
      "bussinessCenter": "string",
      "expirationDate": "2023-03-27T20:50:21.336Z",
      "alphaSeries": "string",
      "alphaNumber": "string",
      "codelect": "string",
      "documentType": "string"
    }
  ]
}
 GetBusinessCenterPlan

Permite obtener el arbol de centros de negocio

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(No Aplica)

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "centrosNegocios": [
    {
      "code": "string",
      "description": "string",
      "imputable": "string",
      "activo": "string",
      "descendientes": [
        null
      ]
    }
  ]
}

SALE

 GetProducts

Permite obtener información de los productos ingresados en la empresa.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Código del producto

No

description

Descripción del producto

No

status

Indica si el producto está activo o no (0/1/2)

itemsPerPage

Cantidad de registros por página.

pageNumber

Número de la página actual.

Respuesta

{
  "totalItems": 2415,
  "pageNumber": 1,
  "itemsPerPage": 1,
  "productList": [
    {
      "active": "S",
      "code": "10",
      "externalCode": "",
      "internalCode": "",
      "name": "VINO",
      "detailedDescription": null,
      "companyID": "20180808202443996002",
      "coinID": "PESO",
      "sellPrice": 0,
      "stock": 0,
      "type": null,
      "unit": "UN",
      "priceListDetail": [],
      "stockDetail": []
   }
  ]
}
 SaveProduct

Permite crear un Artículo con los datos necesarios y su respectiva información.

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Código del producto o servicio.

name

Nombre del producto o servicio

unit

Unidad de medida del producto o servicio

No

price

Precio base del producto o servicio.

description

Descripción del producto o servicio

isService

Indica si es servicio o artículo (true/false)

Respuesta

{
  "success": true,
  "message": "Producto Guardado Exitosamente"
}
 GetClients

Permite obtener un listado de los clientes asociados a la empresa.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

legalCode

Código legal del cliente.

No

description

Nombre o descripción del cliente

No

status

Estado actual del cliente (0/1/2 = Todos / Activos / Inactivos)

itemsPerPage

Cantidad de registros por página

pageNumber

Número de la página actual.

Respuesta

{
  "totalItems": 10207,
  "pageNumber": 1,
  "itemsPerPage": 1,
  "clientList": [
    {
      "active": "S",
      "isProvider": "S",
      "lastName1": null,
      "lastName2": null,
      "city": "",
      "client": "S",
      "legalCode": "00.000.000-0",
      "agreedDiscount": 0,
      "address": "",
      "district": "",
      "email": "",
      "sendEmailDTE": "",
      "state": "",
      "fax": "",
      "business": "",
      "companyID": "20180808202443996002",
      "fileID": "00.000.000-0",
      "localID": "AW",
      "coinID": "PESO",
      "paymentID": "CONTADO",
      "productID": null,
      "rubroId": "POR DEFINIR",
      "docTypeID": "XBVTAFEC",
      "sellerID": "SGN",
      "priceList": "3",
      "name": "CLIENTES ACUMULADOS HASTA EL 2018",
      "country": "",
      "poBox": "",
      "provider": "S",
      "phone": "",
      "productType": "S",
      "tipRcgoDctoDocVta": "P",
      "usaRcgoDctoDocVta": "",
      "webSite": "",
      "zipCode": ""
    }
  ]
}
 SaveClient

Permite guardar la información de un cliente de la empresa.

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

legalCode

Código legal del cliente

name

Nombre del cliente

address

Dirección del cliente

district

Distrito del cliente

email

Email del cliente.

No

business

Negocio del cliente

rubroId

Rubro del cliente

giro

Giro del cliente

Respuesta

{
  "success": true,
  "message": "Cliente Guardado Exitosamente"
}
 GetSellers

Permite obtener la información de los vendedores asociados a la empresa.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Identificador del vendedor

No

ItemsPerPage

Cantidad de registros por página

PageNumber

Número de página

Respuesta

{
  "totalItems": 28,
  "pageNumber": 1,
  "itemsPerPage": 1,
  "sellerList": [
    {
      "code": "APS",
      "name": "NOMBRE VENDEDOR"
    }
  ]
}
 GetShops

Permite obtener la información de los locales asociados a la empresa.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Identificador del local de venta

No

ItemsPerPage

Cantidad de registros por página

PageNumber

Número de página

Respuesta

{
  "totalItems": 6,
  "pageNumber": 1,
  "itemsPerPage": 1,
  "shopList": [
    {
      "code": "000001",
      "description": "LOCAL01",
      "address": "DIRECCIÓN, 2000",
      "bussinessCode": "001001001001000",
      "storage": "BODEGACENTRAL"
    }
  ]
}
 GetStorages

Permite obtener la información de los locales asociados a la empresa.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Identificador de la bodega.

No

ItemsPerPage

Cantidad de registros por página

PageNumber

Número de página.

Respuesta

{
  "totalItems": 22,
  "pageNumber": 1,
  "itemsPerPage": 1,
  "storageList": [
    {
      "code": "BODEGACENTRAL",
      "description": "BODEGA CENTRAL",
      "saleAvailable": "S",
      "active": "S"
    }
  ]
}
 GetDocumentInfo

Permite obtener la información de los documentos configurados en la empresa.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Identificador de la bodega.

No

ItemsPerPage

Cantidad de registros por página.

PageNumber

Número de página.

Respuesta

{
  "totalItems": 37,
  "pageNumber": 1,
  "itemsPerPage": 1,
  "documentList": [
    {
      "code": "BVTAFEC",
      "electronicCode": "35",
      "name": "BOLETA DE VENTA AFECTA",
      "voucherInfo": "Vta_BVTAFEC"
    }
  ]
}
 GetDocumentAnalysis

Permite obtener la información de centralización de los documentos configurados en la empresa.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Identificador de la bodega.

No

ItemsPerPage

Cantidad de registros por página.

PageNumber

Número de página.

Respuesta

{
  "totalItems": 18,
  "pageNumber": 1,
  "itemsPerPage": 1,
  "documentList": [
  {
    "documentId": "BVTAFEC",
    "analysisDetail": [
    {
      "analysisType": "CLT",
      "analysisCode": "Unico",
      "accountNumber": "1212121221",
      "unico": "S"
    },
    {
      "analysisType": "IMP",
      "analysisCode": "IVA",
      "accountNumber": "1313131313",
      "unico": "N"
    },
    {
      "analysisType": "VTA",
      "analysisCode": "Unico",
      "accountNumber": "1414141414",
      "unico": "S"
    }
  ]
}
 GetDistricts

Permite consultar el id del distrito (Comuna) del cliente para el posterior guardado del mismo.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

State

Indica la región del cliente

No

Respuesta

{
  "totalItems": 1,
  "districtList": [
    {
      "country": "CL",
      "stateListDetail": [
      {
        "stateName": "I REGION DE TARAPACA",
        "districtListDetail": [
        {
          "districtCode": "CAMINA",
          "districtName": "CAMINA"
        },
        {
          "districtCode": "COLCHANE",
          "districtName": "COLCHANE"
        }, 
        …
        {
          "districtCode": "POZO ALMONTE",
          "districtName": "POZO ALMONTE"
        }
      ]
    }
  ]
}
]
}
 SaveSale

Permite insertar un movimiento de ventas para una empresa.

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

documentType

Indica el identificador del tipo de documento

firstFolio

Indica el folio del documento, al ser electrónico debe ingresarse con valor 0 ya que es automático

lastFolio

Indica el último folio a utilizar, al ser electrónico debe ingresarse con valor 0 ya que es automático.

emissionDate

Indica la fecha de emisión del documento bajo el siguiente formato:
"emissionDate": {
"day": 0,
"month": 0,
"year": 0
},

firstFeePaid

Indica la fecha del primer pago del documento bajo el siguiente formato:
" firstFeePaid ": {
"day": 0,
"month": 0,
"year": 0
},

clientFile

Indica el rut del cliente.

contactIndex

Indica la dirección del cliente.

paymentCondition

Indica la condición de pago

sellerFileId

Indica el identificador del vendedor

clientAnalysis

Análisis por cliente bajo el siguiente formato:
"clientAnalysis": {
"accountNumber": "1110401001",
"businessCenter": "",
"classifier01": "",
"classifier02": ""
},

saleAnalysis

Análisis por venta bajo el siguiente formato:
"saleAnalysis": {
"accountNumber": "1110401001",
"businessCenter": "",
"classifier01": "",
"classifier02": ""
},

billingCoin

Indica la moneda de ingreso

billingRate

Indica la taza de monda de ingreso (PESO = 1)

shopId

Indica el identificador del local de venta

priceList

Indica la lista de precio.

giro

Indica el giro del documento

district

Indica el distrito

contact

Indica el contacto

attachedDocuments

Indica los documentos asociados bajo el siguiente formato:
"attachedDocuments": [
{
"date": {
"day": 10,
"month": 4,
"year": 2020
},
"documentTypeId": "801",
"folio": "135",
"reason": "Orden de compra"
}
],

No

storage

Indica la bodega de venta para la rebaja de inventario bajo el siguiente formato:
"storage": {
"code": "BODEGACENTRAL",
"motive": "MOTIVO DE VENTA",
"storageAnalysis": {
"accountNumber": "4110101001",
"businessCenter": "",
"classifier01": "",
"classifier02": ""
}
},

details

Indica los detalles de la venta bajo el siguiente formato:
"details": [
{
"type": "A",
"code": "10001TIBL001",
"count": 1,
"productName": "PRODUCTO",
"productNameBarCode": "PRODUCTO01",
"price": 1000,
"unit": "UN",
"analysis": {
"accountNumber": "1110401001",
"businessCenter": "",
"classifier01": "",
"classifier02": ""
}
}

saleTaxes

Indica los impuestos asociados a la venta bajo el siguiente formato:
"saleTaxes": [
{
"code": "IVA",
"value": 19
}
],

ventaRecDesGlobal

Indica los recargos y/o descuentos globales de la venta bajo el siguiente formato:
"ventaRecDesGlobal": [
{
"amount": 0,
"modifierClass": "PV",
"name": "string",
"percentage": 0,
"value": 0
}
],

gloss

Indica la glosa o comentario del documento

isTransferDocument

Indica si es un documento de traspaso o no (true/false). Si el valor se envía como “true”, el documento ingresado no será enviado al SII, sino que solamente se almacenará en el ERP

Respuesta

{
  "firstFolio": 130,
  "lastFolio": 0,
  "success": true,
  "message": "Documento guardado exitosamente"
}
 GetSale

Permite obtener la información una venta en específico.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

documentType

Identificador del tipo de documento.

number

Folio del documento

Respuesta

[
{
  "documentType": "XFVAELECT",
  "firstFolio": 4359,
  "lastFolio": 0,
  "emissionDate": "2020-05-25T00:00:00",
  "clientFile": "11.111.111-1",
  "contactIndex": "Mariano Sánchez Fontecilla 348",
  "paymentCondition": "CONTADO",
  "sellerFileId": "VENDEDOR",
  "billingCoin": "PESO",
  "billingRate": 1,
  "shopId": "Local",
  "priceList": "1",
  "giro": "PARTICULAR",
  "district": "DISTRITO",
  "contact": 1,
  "attachedDocuments": [],
  "details": [
    {
      "detailLine": 1,
      "type": "A",
      "code": "10001TIBL001",
      "count": 1,
      "price": 1000,
      "discountType": "M",
      "discountValue": 0,
      "analysis": "Unico",
      "total": 1000,
      "priceList": 17000
    },
    {
      "detailLine": 2,
      "type": "A",
      "code": "10001TIBL001",
      "count": 2,
      "price": 1000,
      "discountType": "M",
      "discountValue": 0,
      "analysis": "Unico",
      "total": 2000,
      "priceList": 17000
    }
    ],
      "gloss": "GLOSA",
      "affectableTotal": 3000,
      "exemptTotal": 0,
      "taxeCode": "IVA",
      "taxeValue": 570,
      "total": 3570,
      "voucherInfo": [
    {
      "folio": 4359,
      "year": "2020",
      "type": "Vta_XFVAELECT"
    }
    ],
      "isTransferDocument": "N"
  }
]
 GetSaleByDate

Permite obtener la información de las ventas por un periodo de tiempo.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

initialDate

Fecha inicial de búsqueda (yyyy-mm-dd)

endingDate

Fecha final de búsqueda (yyyy-mm-dd)

documentType

Tipo de documento

No

itemsPerPage

Cantidad de registros por página

pageNumber

Número de página.

Respuesta

{
  "totalItems": 521,
  "pageNumber": 1,
  "itemsPerPage": 1,
  "saleList": [
    {
      "documentType": "BOLETAVTAFEC",
      "firstFolio": 1159,
      "lastFolio": 0,
      "emissionDate": "2020-01-02T00:00:00",
      "clientFile": "11.111.111-1",
      "contactIndex": "DIRECCION 67",
      "paymentCondition": "CONTADO",
      "sellerFileId": "IDVENDEDOR",
      "billingCoin": "PESO",
      "billingRate": 1,
      "shopId": "IDLOCAL",
      "priceList": "3",
      "giro": "Particular",
      "district": "SANTIAGO",
      "contact": -1,
      "attachedDocuments": [
        {
          "date": "2019-10-16T00:00:00",
          "attachedDocumentType": "XBVTAFEC",
          "attachedDocumentName": "BOLETA ELECTRONICA",
          "attachedDocumentTotal": 35340,
          "documentTypeId": "NCBOLETAVTAFEC",
          "folio": 1159,
          "reason": null,
          "gloss": ""
        }
        ],
          "details": [
        {
          "detailLine": 1,
          "type": "A",
          "code": "11111",
          "count": 5,
          "price": 5590,
          "discountType": "P",
          "discountValue": 0,
          "analysis": "Unico",
          "total": 27950,
          "priceList": 5590
        }
        ],
          "gloss": "",
          "affectableTotal": 23487,
          "exemptTotal": 0,
          "taxeCode": "IVA",
          "taxeValue": 4463,
          "total": 27950,
          "voucherInfo": [
        {
          "folio": 1159,
          "year": "2020",
          "type": "Vta_NCBOLETAVTAFEC"
        }
      ],
      "isTransferDocument": "N"
    }
  ]
}
 SaveSimpleDate

Permite la grabación de boletas o facturas simples

Condiciones Preliminares

Al ser una venta simplificada, es necesario que el usuario tenga configurados los siguientes parámetros en ERP:

Parámetro

Valor

Requerido

Vendedor

“VENDEDOR”

Local de venta

“LOCAL”

Bodega de stock

“BODEGACENTRAL”

Impuesto

“IVA”

Condición de pago

“CONTADO”

Si

Análisis del documento

“UNICO”

Moneda de ingreso

“PESO”

Tipo de documento

“XFVAELECT”
“XBVTAFECT”

Headers

Tipo

Valor

Requeridos

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

electronicCode

Código electrónico del documento

firstFolio

Indica el folio del documento, al ser electrónico debe ingresarse con valor 0 ya que es automático

emissionDate

Indica la fecha de emisión del documento bajo el siguiente formato:
"emissionDate": {
"day": 0,
"month": 0,
"year": 0
},

clientFile

Indica el rut del cliente

district

Indica el distrito

details

Indica los detalles de la venta bajo el siguiente formato:
"details": [
{
"type": "A",
"code": "10001TIBL001",
"count": 1,
"price": 1000,
}
]

ventaRecDesGlobal

Indica los recargos y/o descuentos globales de la venta bajo el siguiente formato:
"ventaRecDesGlobal": [
{
"amount": 0,
"modifierClass": "PV",
"name": "string",
"percentage": 0,
"value": 0
}
],

gloss

Indica la glosa o comentario del documento

isTransferDocument

Indica si es un documento de traspaso o no (true/false). Si el valor se envía como “true”, el documento ingresado no será enviado al SII, sino que solamente se almacenará en el ERP

Respuesta

{
  "firstFolio": 130,
  "lastFolio": 0,
  "success": true,
  "message": "Documento guardado exitosamente"
}
 SaveCreditNote

Permite guardar una nota de crédito.

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

creditNoteTypeId

Indica el identificador del tipo de documento para la nota de crédito

documentType

Indica el identificador del tipo de documento a ser anulado

folio

Indica el folio del documento a ser anulado

gloss

Breve comentario sobre el documento

emissionDate

Indica la fecha de emisión del documento bajo el siguiente formato:
"emissionDate": {
"day": 0,
"month": 0,
"year": 0
},

isTransferDocument

Indica si es un documento de traspaso o no (true/false). Si el valor se envía como “true”, el documento ingresado no será enviado al SII, sino que solamente se almacenará en el ERP.

Respuesta

{
  "firstFolio": 130,
  "lastFolio": 0,
  "success": true,
  "message": "Documento guardado exitosamente"
}
 GetPDFDocumentBase64

Permite obtener la información de los locales asociados a la empresa.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

documentType

Identificador del local de venta.

folio

Cantidad de registros por página.

Respuesta

"document": "JVBERi0xLjINCg0KMyAwIG9iag0KPDwNCi9FIDIzNTIxDQovSCBbIDExNzAgMTU3IF0NCi
9MIDIzNzUzDQovTGluZWFyaXplZCAxDQovTiAxDQovTyA2DQovVCAyMzY0Mw0KPj4gICAgICAgICAgICAgI
CAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgDQplbmRv
YmoNCg0KeHJlZg0KMyAxMQ0KMDAwMDAwMDAxMiAwMDAwMCBuDQowMDAwMDAxMDQ3IDAwMDAwIG4NCjAwMDA
wMDExNzAgMDAwMDAgbg0KMDAwMDAwMTMyOCAwMDAwMCBuDQowMDAwMDAxNjIyIDAwMDAwIG4NCjAwMDAwMD
E3MzEgMDAwMDAgbg0KMDAwMDAwMTg0MyAwMDAwMCBuDQowMDAwMDAxOTUwIDAwMDAwIG4NCjAwMDAwMTM2M
TkgMDAwMDAgbg0KMDAwMDAxMzg4OCAwMDAwMCBuDQowMDAwMDIwNjQ5IDAwMDAwIG4NCnRyYWlsZXINCjw8
DQovQUJDcGR….}
 SavePriceList

Permite guardar una nueva lista de precios

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

PriceListId

Identificador de la lista de precios

Description

Descripción de la lista de precios

Respuesta

{
  "success": true,
  "message": "Lista de precio 10 Guardada Exitosamente",
  "exceptionMessage": null
}
 SaveProductPriceList

Permite agregar un artículo a una lista de precios

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

PriceListInput

Información del producto a ingresar

Respuesta

{
  "success": true,
  "message": "Producto 10003TICS003 Guardado Exitosamente",
  "exceptionMessage": null
}
 GetServices

Permite obtener información sobre los servicios asociados a la empresa.

Ambientes

Verbo HTTP: Get

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Code

Código del servicio

No

Description

Descripción del servicio

No

itemPerPage

Registros por página

PageNumber

Número de página

Respuesta

{
  "totalItems": 38,
  "pageNumber": 1,
  "itemsPerPage": 1,
  "serviceList": [
    {
      "code": "1",
      "description": "SERVICIOS",
      "detailedDescription": null,
      "sellPrice": 0,
      "unit": "",
      "unitCost": 0,
      "useOT": null
    }
  ]
}
 SaveExportCreditNote

Permite generar una nota de crédito o débito para facturas de exportación

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json“

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descipción

Requerido

Respuesta

{
  "documentType": "string",
  "firstFolio": 0,
  "lastFolio": 0,
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}

 SaveExportSale

Permite registrar un documento de exportación

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json“

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

documentType

firstFolio

lastFolio

externalDocumentID

emissionDate

day, month, year

firstFeePaid

day, month, year

clientFile

clientInfo

fileID, name, address, city, district, giro, phone

contactIndex

paymentCondition

sellerFileId

clientAnalysis

accountNumber, businessCenter, classifier01, classifier02

saleAnalysis

accountNumber, businessCenter, classifier01, classifier02

billingCoin

billingRate

shopId

priceList

giro

district

contact

attachedDocuments

Date: day, month, year. documentTypeId, folio, reason

storage

code, motive.

storageAnalysis: accountNumber, businessCenter, classifier01, classifier02

details

type, code, count, productName, productNameBarCode, comment, price, unit, analysis: accountNumber, businessCenter, classifier01, classifier02

ventaRecDesGlobal

amount, modifierClass, name, percentage, value

gloss

exportdata

destinationCountry, destinationMerchandise

grossWeight: value, unit

landingPort,

package: value, unit

paymentMethod, saleClause, saleMode, serviceIndicator, shipmentPort

tareMeasure: value, unit

totalClause, transportWay

weight: value, unit

isTransferDocument

Si corresponde a un movimiento de traspaso

No

Respuesta

{
  "documentType": "string",
  "firstFolio": 0,
  "lastFolio": 0,
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 SaveCreditNoteSkipCentralization

Permite ingresar notas de crédito de anulación sin centralización

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json“

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

creditNoteTypeId

Código del documento

documentType

Tipo de documento

folio

Número del documento

externalDocumentID

Identificador del documento de referencia

gloss

Glosa

emissionDate

Fecha de emisióndel documento

isTransferDocument

Es un documento de transferencia, S o N

No

Respuesta

{
  "documentType": "string",
  "firstFolio": 0,
  "lastFolio": 0,
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 UpdateProduct

Permite actualizar un producto

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Código del artículo o servicio

externalCode

Código externo del artículo o servicio

No

internalCode

Código interno del artículo o servicio

No

name

Nombre del artículo o servicio

No

unit

Unidad de medida del artículo o servicio

No

price

Precio unitario del artículo o servicio

No

description

Descripción del artículo o servicio

No

isService

Si corresponde a un servicio, S o N

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 SaveProductExtended

Permite guardar un producto con el código externo e interno

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Code

Código del artículo/servicio

ExternalCode

Código externo del artículo/servicio

InternalCode

Código interno del artículo/servicio

Name

Nombre breve del artículo/servicio

Price

Precio del artículo/servicio

Description

Nombre largo o descriptivo del artículo/servicio

No

isService

Si corresponde a un servicio, S o N o Vacío

No

Respuestas

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 RemoveProduct

Permite dejar inactivo un artículo o servicio

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Código del artículo o servicio

isService

Si corresponde a un servicio, S o N

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 GetProductsPOSByBarCode

Permite la consulta de multiples articulos mediante su codigo de barra.

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Código del producto

Respuesta

{
  "success": true,
  "message": "string",
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "productList": [
    {
      "active": "string",
      "code": "string",
      "externalCode": "string",
      "internalCode": "string",
      "name": "string",
      "detailedDescription": "string",
      "companyID": "string",
      "coinID": "string",
      "sellPrice": 0,
      "stock": 0,
      "type": "string",
      "unit": "string",
      "imptoAd": "string",
      "idImptoAd": "string",
      "usesLotes": true,
      "usesSeries": true,
      "priceListDetail": [
        {
          "priceList": {
            "companyID": "string",
            "priceListID": 0,
            "description": "string",
            "factor": 0,
            "range": 0
          },
          "priceListID": 0,
          "productID": "string",
          "unitPrice": 0
        }
      ],
      "stockDetail": [
        {
          "companyID": "string",
          "productID": "string",
          "storageID": "string",
          "stock": 0,
          "totalReservedStock": 0
        }
      ],
      "reservedStock": [
        {
          "orderNumber": 0,
          "shopID": "string",
          "storageID": "string",
          "reservedStock": 0
        }
      ]
    }
  ]
}

 GetProductsPOSByCode

Permite la consulta de múltiples productos mediante su código.

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Código del producto

Respuesta

{
  "success": true,
  "message": "string",
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "productList": [
    {
      "active": "string",
      "code": "string",
      "externalCode": "string",
      "internalCode": "string",
      "name": "string",
      "detailedDescription": "string",
      "companyID": "string",
      "coinID": "string",
      "sellPrice": 0,
      "stock": 0,
      "type": "string",
      "unit": "string",
      "imptoAd": "string",
      "idImptoAd": "string",
      "usesLotes": true,
      "usesSeries": true,
      "priceListDetail": [
        {
          "priceList": {
            "companyID": "string",
            "priceListID": 0,
            "description": "string",
            "factor": 0,
            "range": 0
          },
          "priceListID": 0,
          "productID": "string",
          "unitPrice": 0
        }
      ],
      "stockDetail": [
        {
          "companyID": "string",
          "productID": "string",
          "storageID": "string",
          "stock": 0,
          "totalReservedStock": 0
        }
      ],
      "reservedStock": [
        {
          "orderNumber": 0,
          "shopID": "string",
          "storageID": "string",
          "reservedStock": 0
        }
      ]
    }
  ]
}

 GetLastUsedFolio

Permite obtener el último folio utilizado

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

documentType

Código del tipo de documento

Respuesta

{
  "success": true,
  "documentType": "string",
  "electronicCode": "string",
  "folio": 0,
  "message": "string",
  "exceptionMessage": "string"
}
 SaveDebitNote

Permite guardar una nota de débito de Ventas

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

debitNoteTypeId

debitNoteType

documentType

clientAnalysis

accountNumber, businessCenter, classifier01, classifier02

folio

gloss

emissionDate

day, month, year

details

type, isExempt, code, count, productName, productNameBarCode, price, unit,

analysis: accountNumber, businessCenter, classifier01, classifier02

saleTaxes

code, value,

taxeAnalysis: accountNumber, businessCenter, classifier01, classifier02

storage

code

motive

storageAnalysis

accountNumber, businessCenter, classifier01, classifier02

isTransferDocument

Respuesta

{
  "documentType": "string",
  "firstFolio": 0,
  "lastFolio": 0,
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 GetProductsGroup

Permite la consulta de un grupo de artículos divididos por su código

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Código del producto

Respuesta

{
  "success": true,
  "message": "string",
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "productList": [
    {
      "active": "string",
      "code": "string",
      "externalCode": "string",
      "internalCode": "string",
      "name": "string",
      "detailedDescription": "string",
      "companyID": "string",
      "coinID": "string",
      "sellPrice": 0,
      "stock": 0,
      "type": "string",
      "unit": "string",
      "imptoAd": "string",
      "idImptoAd": "string",
      "usesLotes": true,
      "usesSeries": true,
      "priceListDetail": [
        {
          "priceList": {
            "companyID": "string",
            "priceListID": 0,
            "description": "string",
            "factor": 0,
            "range": 0
          },
          "priceListID": 0,
          "productID": "string",
          "unitPrice": 0
        }
      ],
      "stockDetail": [
        {
          "companyID": "string",
          "productID": "string",
          "storageID": "string",
          "stock": 0,
          "totalReservedStock": 0
        }
      ],
      "reservedStock": [
        {
          "orderNumber": 0,
          "shopID": "string",
          "storageID": "string",
          "reservedStock": 0
        }
      ]
    }
  ]
}
 GetProductsPOS

Permite la consulta de artículos para POS

Ambientes

Verbo HTTP: Get

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Código del producto

No

description

Descripción del producto

No

status

Estado del producto, S o N

itemsPerPage

Cantidad de resultados por página

pageNumber

Número de página

Respuesta

{
  "success": true,
  "message": "string",
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "productList": [
    {
      "active": "string",
      "code": "string",
      "externalCode": "string",
      "internalCode": "string",
      "name": "string",
      "detailedDescription": "string",
      "companyID": "string",
      "coinID": "string",
      "sellPrice": 0,
      "stock": 0,
      "type": "string",
      "unit": "string",
      "imptoAd": "string",
      "idImptoAd": "string",
      "usesLotes": true,
      "usesSeries": true,
      "priceListDetail": [
        {
          "priceList": {
            "companyID": "string",
            "priceListID": 0,
            "description": "string",
            "factor": 0,
            "range": 0
          },
          "priceListID": 0,
          "productID": "string",
          "unitPrice": 0
        }
      ],
      "stockDetail": [
        {
          "companyID": "string",
          "productID": "string",
          "storageID": "string",
          "stock": 0,
          "totalReservedStock": 0
        }
      ],
      "reservedStock": [
        {
          "orderNumber": 0,
          "shopID": "string",
          "storageID": "string",
          "reservedStock": 0
        }
      ]
    }
  ]
}
 GetPaymentConditions

Permite consultar las condiciones de pago que posee la empresa

Ambientes

Ámbito

URL

Prueba

https://replapi.defontana.com/api/Sale/GetPaymentConditions

Producción

https://api.defontana.com/api/Sale/GetPaymentConditions

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(no aplica)

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "items": [
    {
      "code": "string",
      "name": "string",
      "type": "string",
      "duesAmount": 0,
      "daysBetweenPayments": 0
    }
  ]
}

 GetTaxes

Permite consultar los impuestos que posee la empresa

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(no aplica)

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "taxes": [
    {
      "code": "string",
      "name": "string",
      "value": 0,
      "type": "string",
      "isFixedValue": true
    }
  ]
}
 GetCoinsId

Permite consultar los tipos de moneda, tasa de cambio y su fecha

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerrido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

coinId

Identificador de la moneda

rateDate

Rango de fechas

No

Respuesta

{
  "totalItems": 0,
  "coinList": [
    {
      "coinID": "string",
      "name": "string",
      "rateList": [
        {
          "rate": 0,
          "date": "2021-04-09T14:05:32.615Z"
        }
      ]
    }
  ]
}
 GetPriceList

Permite obtener el listado de lista de precios asociadas a la empresa

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

PriceListId

Código de la lista de precio

itemsPerPage

Ítemes por página

pageNumber

Número de página

Respuesta

{
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "priceList": [
    {
      "priceListID": 0,
      "description": "string"
    }
  ]
}

 GetPriceListDetail

Permite obtener los productos y sus precios de una lista de precios en especifico

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

PriceListId

Código de la lista de precio

pagePerNumber

Ítemes por página

pageNumber

Número de página

Respuesta

{
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "priceListID": 0,
  "priceListDetail": [
    {
      "productID": "string",
      "productPrice": 0
    }
  ]
}
 GetRubro

Permite obtener un listado de los rubros

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

rubroId

Código del rubro

itemsPerPage

Ítemes por página

pageNumber

Número de página

Respuesta

{
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "success": true,
  "rubroList": [
    {
      "rubroID": 0,
      "description": "string",
      "subRubroList": [
        {
          "subRubroID": 0,
          "description": "string"
        }
      ]
    }
  ]
}
 ActivateProduct

Permite activar un artículo o servicio

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(no aplica)

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 GetCustomFields

Permite obtener información sobre los campos personalizables de un tipo de documento.

Ambientes

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

documentID

Código del tipo de documento

Respuesta

{
  "success": true,
  "message": "string",
  "documentID": "string",
  "customFieldList": [
    {
      "number": 0,
      "name": "string",
      "size": 0,
      "type": "string"
    }
  ]
}
 GetProductProperties

Permite obtener las propiedades configurables de un producto

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Code

Código del producto

No

Description

Descripción del producto

No

Status

Estado del producto, valores 0, 1 y 2

itemsPerPage

Cantidad de elementos por página (máximo 100)

PageNumber

Número de página

Respuesta

{
  "success": true,
  "message": "string",
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,URL
  "productList": [
    {
      "code": "string",
      "productPropierties": [
        {
          "className": "string",
          "classValue": "string"
        }
      ]
    }
  ]
}
 GetProductsByCategory

Permite obtener los productos por categoría registrados en la empresa

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

categoryID

Identificador de la categoría

itemsPertPage

Cantidad de elementos por página (máximo 100)

PageNumber

Número de página

Respuesta

{
  "success": true,
  "message": "string",
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "categoryID": "string",
  "productList": [
    {
      "active": "string",
      "code": "string",
      "externalCode": "string",
      "internalCode": "string",
      "name": "string"
    }
  ]
}
 GetClientsByFileID

Obtiene la información de los clientes asociados a la empresa con el filtro por ID de ficha.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

fileID

Código de la ficha

No

description

Nombre de la ficha

No

status

Estado de la ficha, valores 0, 1, 2

itemsPerPage

Registros por página

PageNumber

Número de página

Respuesta

{
  "success": true,
  "message": "string",
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "clientList": [
    {
      "active": "string",
      "isProvider": "string",
      "lastName1": "string",
      "lastName2": "string",
      "city": "string",
      "client": "string",
      "legalCode": "string",
      "agreedDiscount": 0,
      "address": "string",
      "district": "string",
      "email": "string",
      "sendEmailDTE": "string",
      "state": "string",
      "fax": "string",
      "business": "string",
      "companyID": "string",
      "fileID": "string",
      "localID": "string",
      "coinID": "string",
      "paymentID": "string",
      "productID": "string",
      "rubroId": "string",
      "docTypeID": "string",
      "sellerID": "string",
      "priceList": "string",
      "name": "string",
      "country": "string",
      "poBox": "string",
      "provider": "string",
      "phone": "string",
      "productType": "string",
      "tipRcgoDctoDocVta": "string",
      "usaRcgoDctoDocVta": "string",
      "webSite": "string",
      "zipCode": "string",
      "customFields": [
        {
          "classDescription": "string",
          "classValue": "string"
        }
      ]
    }
  ]
}
 ActivateClient

Permite activar un cliente de la empresa

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

FileID

Identificador del cliente

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 RemoveClient

Permite eliminar un cliente

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ClientID

ID de Ficha del Cliente

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 GetStorageStock

Permite obtener el código de los productos y stock asociados a una bodega.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

storageID

Código de la bodega a consultar

itemsPerPage

Registros por página

pageNumber

Número de página

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "productList": [
    {
      "productID": "string",
      "active": "string",
      "stock": 0,
      "priceListDetail": [
        {
          "priceList": {
            "companyID": "string",
            "priceListID": 0,
            "description": "string",
            "factor": 0,
            "range": 0
          },
          "priceListID": 0,
          "productID": "string",
          "unitPrice": 0
        }
      ]
    }
  ]
}
 GetLegacyCategories

Permite obtener las familias de categorías Legacy de artículos

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Respuesta

 
 GetCategories

Permite obtener las categorías registradas de una empresa

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

itemsPerPage

Registros por página

pageNumber

Número de página

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "itemsPerPage": 0,
  "pageNumber": 0,
  "totalItems": 0,
  "categoriesList": [
    {
      "categoryID": 0,
      "description": "string",
      "subCategories": [
        {
          "subCategoryID": 0,
          "description": "string"
        }
      ]
    }
  ]
}
 GetProductsByCategory

Permite obtener los productos por categoría registrados en la empresa

Ambientes

Verbo HTTP:

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Respuesta

 
 GetSaleByAssociatedDocument

Permite obtener un documento de venta en base a un documento asociado a la misma

Ambientes

Verbo HTTP:

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

associatedDocumentType

Código de tipo de documento asociado (52 = guía de despacho electrónica, 801 = orden de compra, 802 = pedido, etc.)

number

Número de documento asociado

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "sale": {
    "documentType": "string",
    "firstFolio": 0,
    "lastFolio": 0,
    "status": "string",
    "emissionDate": "2021-12-21T19:41:49.073Z",
    "dateTime": "2021-12-21T19:41:49.073Z",
    "expirationDate": "2021-12-21T19:41:49.073Z",
    "clientFile": "string",
    "contactIndex": "string",
    "paymentCondition": "string",
    "sellerFileId": "string",
    "billingCoin": "string",
    "billingRate": 0,
    "shopId": "string",
    "priceList": "string",
    "giro": "string",
    "city": "string",
    "district": "string",
    "contact": 0,
    "attachedDocuments": [
      {
        "date": "2021-12-21T19:41:49.073Z",
        "attachedDocumentType": "string",
        "attachedDocumentName": "string",
        "attachedDocumentNumber": "string",
        "attachedDocumentTotal": 0,
        "documentTypeId": "string",
        "folio": 0,
        "reason": "string",
        "gloss": "string"
      }
    ],
    "details": [
      {
        "detailLine": 0,
        "type": "string",
        "code": "string",
        "count": 0,
        "price": 0,
        "isExempt": "string",
        "discountType": "string",
        "discountValue": 0,
        "analysis": "string",
        "total": 0,
        "priceList": 0,
        "infAnalysis": {
          "accountNumber": "string",
          "businessCenter": "string",
          "classifier01": "string",
          "classifier02": "string"
        }
      }
    ],
    "gloss": "string",
    "affectableTotal": 0,
    "exemptTotal": 0,
    "taxeCode": "string",
    "taxeValue": 0,
    "documentTaxes": [
      {
        "taxeCode1": "string",
        "taxePercentaje1": 0,
        "taxeValue1": 0,
        "taxeCode2": "string",
        "taxePercentaje2": 0,
        "taxeValue2": 0,
        "taxeCode3": "string",
        "taxePercentaje3": 0,
        "taxeValue3": 0,
        "taxeCode4": "string",
        "taxePercentaje4": 0,
        "taxeValue4": 0,
        "taxeCode5": "string",
        "taxePercentaje5": 0,
        "taxeValue5": 0
      }
    ],
    "ventaRecDesGlobal": [
      {
        "amount": 0,
        "modifierClass": "string",
        "name": "string",
        "percentage": 0,
        "value": 0
      }
    ],
    "total": 0,
    "voucherInfo": [
      {
        "folio": 0,
        "year": "string",
        "type": "string"
      }
    ],
    "inventoryInfo": [
      {
        "folio": 0,
        "fiscalYear": "string",
        "documentType": "string"
      }
    ],
    "customFields": [
      {
        "classDescription": "string",
        "classValue": "string"
      }
    ],
    "exportData": [
      {
        "exportBillingRate": 0,
        "exportBillingCoinID": "string",
        "totalExport": 0,
        "exemptExport": 0,
        "destinationCountry": "string",
        "destinationMerchandise": "string",
        "landingPort": "string",
        "saleClause": "string",
        "saleMode": "string",
        "shipmentPort": "string",
        "totalClause": 0,
        "transportWay": "string"
      }
    ],
    "isTransferDocument": "string",
    "timestamp": "2021-12-21T19:41:49.074Z"
  }
}
 GetCurrentCost

Permite obtener el costo vigente de un producto

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Code

Id de artículo a consultar

Date

Fecha en la que se quiere consultar el valor del costo vigente

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "code": "string",
  "date": "2021-12-21T19:34:05.612Z",
  "cost": 0
}
 GetReplacementCost

Permite obtener costo de reposicion de un producto

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Code

Id de artículo a consultar

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "replacementCost": 0,
  "code": "string"
}
 GetAssociatedDocumentsBySale

Permite consultar los documentos asociados a una venta.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

documentType

Especifica el id del tipo de documento a consultar

number

Especifica el folio del documento a consultar

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "saleList": [
    {
      "number": 0,
      "documentType": "string"
    }
  ]
}

PURCHASEORDER

 List

Permite obtener un listado de órdenes de compra ingresadas al sistema

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

FromDate

Fecha mínima desde la que se desea filtrar resultados

ToDate

Fecha máxima hasta la que se desea filtrar resultados

ItemsPerPage

Cantidad de elementos por página (máximo 100)

Page

Página a consultar (comienza en 0)

ProviderNameOrLegalCode

Rut o nombre de proveedor

No

Status

  • 0 = TODOS

  • 1 = INGRESADO

  • 2 = APROBADO

  • 3 = PARCIALMENTE RECEPCIONADO

  • 4 = COMPLETAMENTE RECEPCIONADO

  • 5 = CERRADO

  • 6 = ANULADO

  • 7 = APROBADO o PARCIALMENTE RECEPCIONADO

No

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "data": [
    {
      "providerId": "string",
      "status": "string",
      "emissionDate": "2020-06-26T20:21:14.994Z",
      "totalLocalCurrency": "string",
      "totalEntryCurrency": "string",
      "documentSerie": "string",
      "number": 0,
      "providerName": "string",
      "providerLegalCode": "string"
    }
  ],
  "totalItems": 0,
  "page": 0,
  "itemsPerPage": 0,
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 Get

Permite obtener los datos en detalle de una orden de compra

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Series

Serie de la Orden de Compra

No

Number

Número de la Orden de Compra

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "purchaseOrderData": {
    "dispatchState": "string",
    "dispatchDistrict": "string",
    "dispatchAddress": "string",
    "dispatchContact": "string",
    "approveState": "string",
    "billingState": "string",
    "receiptState": "string",
    "emissionState": "string",
    "amountTotalInputCurrency": 0,
    "taxesInputCurrency": 0,
    "modifiersInputCurrency": 0,
    "amoutExemptInputCurrency": 0,
    "amountBeforeTaxesInputCurrency": 0,
    "amountTotal": 0,
    "taxes": 0,
    "modifiers": 0,
    "amoutExempt": 0,
    "amountBeforeTaxes": 0,
    "exchangeRate": 0,
    "entryCurrencyData": {
      "id": "string",
      "description": "string",
      "entryDecimals": 0,
      "simbol": "string",
      "usesDecimals": true,
      "siiId": "string"
    },
    "comment": "string",
    "purchaseOrderDetail": [
      {
        "productId": "string",
        "quantity": 0,
        "receivedQuantity": 0,
        "amount": 0,
        "price": 0,
        "amountInputCurrency": 0,
        "comment": "string",
        "receivedAmount": 0,
        "line": 0,
        "discount": 0,
        "discountEntry": 0,
        "discountType": 0,
        "product": {
          "usesLotes": true,
          "usesSeries": true,
          "isArticle": true,
          "isService": true,
          "productId": "string",
          "description": "string",
          "purchaseCurrencyId": "string",
          "inventoryMeasureUnitId": "string",
          "isActive": true
        }
      }
    ],
    "businessCenterData": {
      "businessCenterId": "string",
      "name": "string"
    },
    "receiptDate": "2020-06-26T20:23:28.644Z",
    "expirationDate": "2020-06-26T20:23:28.644Z",
    "emissionDate": "2020-06-26T20:23:28.644Z",
    "providerInfo": {
      "phone": "string",
      "email": "string",
      "district": "string",
      "state": "string",
      "city": "string",
      "providerTypeId": "string",
      "country": "string",
      "businessDescription": "string",
      "name": "string",
      "legalCode": "string",
      "fileId": "string",
      "address": "string",
      "shopId": "string"
    },
    "number": 0,
    "series": "string",
    "dispatchCity": "string",
    "dispatchCountry": "string"
  },
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 GetPurchaseOrderPDFDocumentBase64

Permite obtener el base64 del PDF de un orden de compra en un formato estándar

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Series

Serie de la orden de compra

No

Number

Numero de orden de compra

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "document": "string"
}
 GetPurchaseOrderCustomPDFDocumentBase64

Permite obtener el base64 del PDF de un orden de compra en un formato personalizado

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Series

Serie de la orden de compra

No

Number

Numero de orden de compra

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "document": "string"
}
 InsertReceptionDocument

Permite ingresar un documento de recepción

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

providerId

Identificador del proveedor

purchaseOrderNumber

Número de la orden de compra

series

SErie de la orden de compra

No

storageCode

Código de barra

No

line

Número de la línea de detalle

productId

Identificador del producto

quantity

Cantidad

total

Total de la línea

isService

Si es servicio (S o N)

No

 GetProviders

Obtiene la información de los proveedores asociados a la empresa

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

legalCode

Código legal

No

description

Descripción

No

status

Estado

  • 0 = Todos

  • 1 = Activos

  • 2 = Inactivos

itemsPerPage

Registros por página

PageNumber

Número de página

 UpdateState

Permite modificar el estado de una orden de compra

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Series

Serie de la OC

No

Number

Número de la OC

Status

Estado

  • 2 = APROBADO

  • 3 = PARCIALMENTE RECEPCIONADO

  • 4 = COMPLETAMENTE RECEPCIONADO

  • 5 = CERRADO

  • 6 = ANULADO

 RemoveProvider

Permite eliminar un proveedor

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requesito

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

code

Código del proveedor

Respuesta

De retorno, en caso de haber ingresado el JSON de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 UpdateProvider

Permite actualizar los datos de un proveedor

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

legalCode

Código legal del proveedor

name

Nombre del proveedor

address

Dirección del proveedor

No

district

Comuna del proveedor

No

email

Email del proveedor

No

business

Negocio del proveedor

No

rubroId

Rubro del proveedor

No

giro

Giro del proveedor

No

city

Ciudad del proveedor

No

phone

Teléfono del proveedor

No

Respuesta

De retorno, en caso de haber ingresado el JSON de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 SaveProvider

Permite guardar un proveedor

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

legalCode

Código legal del proveedor

name

Nombre del proveedor

address

Dirección del proveedor

No

district

Comuna del proveedor

No

email

Email del proveedor

No

business

Negocio del proveedor

No

rubroId

Rubro del proveedor

No

giro

Giro del proveedor

No

city

Ciudad del proveedor

No

phone

Teléfono del proveedor

No

Respuesta

De retorno, en caso de haber ingresado el JSON de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 InsertPurchaseOrder

Permite insertar ordenes de compra

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application-json“

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ProviderID

Se define el ID del proveedor

Si

LegalCode (ProviderData)

Se define el RUT del proveedor

No

Name (ProviderData)

Se define el nombre del proveedor

No

Address (ProviderData)

Se define la dirección del proveedor

No

District (ProviderData)

Se define la comuna del proveedor

No

Email (ProviderData)

Se define el correo electrónico del proveedor

No

Business (ProviderData)

Se define el centro de negocio configurado para el proveedor

No

RubroId (ProviderData)

Se define el rubro del proveedor

No

Giro (ProviderData)

Se define el giro del proveedor

No

City (ProviderData)

Se define la ciudad del proveedor

No

Serie

Se define la serie, si manejara enviarlo de lo contrario enviarlo en vacio

No

Number

Se define el numero del documento (para que tome el correlativo enviarlo en 0)

Si

BusinessCenter

Se define el centro de negocio

Si

CoinID

Se define el tipo de moneda

Si

PaymentCondition

Se define el codigo de la condicion de pago

Si

DocumentTypeId

Se define el codigo del tipo de documento a utilizar

Si

ExchangeRate

Se define el tipo de cambio

Si

ReceiptDate

Se define la fecha de recepcion del documento

Si

ExpirationDate

Se define la fecha de expracion del documento

Si

EmissionDate

Se define define la fecha de emision del documento

Si

AmountBeforeTaxes

Se define el monto total antes de aplicarle el impuesto

Si

Modifiers

Se define el modificador a utilizar

Si

AmountExempt

Se define si el monto es exento de iva

Si

AmountTotal

Se define el monto total de documento

Si

Taxes

Se define el monto del impuesto (por defecto siempre va en IVA con monto 19)

Si

IsService (Details)

Se define si es un articulo o servicio

Si

ProductID (Details)

Se define el codigo del articulo o servicio

Si

Quantity (Details)

Se define la cantidad

Si

Total (Details)

Se define el total de la linea de detalle

Si

Discount (Details)

Se define si se desea un descuento en la linea de detalle

Si

DiscountType (Details)

Se define el tipo de descuento en la linea de detalle

Si

Price (Details)

Se define el precio del articulo o servicio

Si

Comment (Details)

Se define un comentario dentro de la linea de detalle

Si

Code (ProductData)

Se define el codigo del articulo o servicio

No

Name (ProductData)

Se define el nombre del articulo o servicio

No

Unit (ProductData)

Se define la unidad de medida del articulo o servicio

No

Price (ProductData)

Se define el precio del articulo o servicio

No

Description (ProductData)

Se define una descripción del articulo o servicio

No

IsService (ProductData)

Se define si es un articulo o servicio

No

dispatchContact

Se define una glosa de contacto de despacho

No

dispatchAddress

Se define una glosa de dirección de despacho

No

dispatchDistrict

Se define una glosa de comuna de despacho

No

dispatchState

Se define una glosa de estado de despacho

No

dispatchCity

Se define una glosa de ciudad de despacho

No

dispatchCountry

Se define una glosa de Pais de despacho

No

dispatchPhone

Se define una glosa de telefono de despacho

No

comment

Se define una glosa del documento general

No

Respuesta

De retorno, en caso de haber ingresado el JSON de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "number": "string"
}
 GetReceptionDocuments

Permite obtener los documento de inventario asociados a una orden de compra.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Number

Número de orden de compra

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "receptionDocumentList": [
    {
      "receptionDocumentNumber": 0,
      "providerID": "string",
      "inventoryDocumentList": [
        {
          "numberDocInv": "string",
          "docTypeInv": "string",
          "storageID": "string",
          "fiscalYear": "string",
          "voucherType": "string",
          "voucherNumber": "string"
        }
      ]
    }
  ]
}
 GetProvidersByFileID

Obtiene la información de los proveedores asociados a la empresa con el filtro por ID de ficha

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application-json“

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

FileID

Código de la ficha

No

Description

Nombre de la ficha

No

Status

Estado de la ficha (0=Todos, 1=Activos, 2=Inactivos)

ItemsPerPage

Registros por página

PageNumber

Número de página

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "providersList": [
    {
      "active": "string",
      "isProvider": "string",
      "lastName1": "string",
      "lastName2": "string",
      "city": "string",
      "client": "string",
      "legalCode": "string",
      "agreedDiscount": 0,
      "address": "string",
      "district": "string",
      "email": "string",
      "sendEmailDTE": "string",
      "state": "string",
      "fax": "string",
      "business": "string",
      "companyID": "string",
      "fileID": "string",
      "localID": "string",
      "coinID": "string",
      "paymentID": "string",
      "productID": "string",
      "rubroId": "string",
      "docTypeID": "string",
      "sellerID": "string",
      "priceList": "string",
      "name": "string",
      "country": "string",
      "poBox": "string",
      "provider": "string",
      "phone": "string",
      "productType": "string",
      "tipRcgoDctoDocVta": "string",
      "usaRcgoDctoDocVta": "string",
      "webSite": "string",
      "zipCode": "string"
    }
  ]
}
 ActivateProvider

Permite poder dejar activo un proveedor registrado

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

FileID

Se define el ID el proveedor

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 UpdatePurchaseOrder

Permite actualizar los datos de una orden de compra

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ProviderID

Se define el ID del proveedor

Si

LegalCode (ProviderData)

Se define el RUT del proveedor

No

Name (ProviderData)

Se define el nombre del proveedor

No

Address (ProviderData)

Se define la dirección del proveedor

No

District (ProviderData)

Se define la comuna del proveedor

No

Email (ProviderData)

Se define el correo electrónico del proveedor

No

Business (ProviderData)

Se define el centro de negocio configurado para el proveedor

No

RubroId (ProviderData)

Se define el rubro del proveedor

No

Giro (ProviderData)

Se define el giro del proveedor

No

City (ProviderData)

Se define la ciudad del proveedor

No

Serie

Se define la serie, si manejara enviarlo de lo contrario enviarlo en vacio

No

Number

Se define el numero del documento (para que tome el correlativo enviarlo en 0)

Si

BusinessCenter

Se define el centro de negocio

Si

CoinID

Se define el tipo de moneda

Si

PaymentCondition

Se define el codigo de la condicion de pago

Si

DocumentTypeId

Se define el codigo del tipo de documento a utilizar

Si

ExchangeRate

Se define el tipo de cambio

Si

ReceiptDate

Se define la fecha de recepcion del documento

Si

ExpirationDate

Se define la fecha de expracion del documento

Si

EmissionDate

Se define define la fecha de emision del documento

Si

AmountBeforeTaxes

Se define el monto total antes de aplicarle el impuesto

Si

Modifiers

Se define el modificador a utilizar

Si

AmountExempt

Se define si el monto es exento de iva

Si

AmountTotal

Se define el monto total de documento

Si

Taxes

Se define el monto del impuesto (por defecto siempre va en IVA con monto 19)

Si

IsService (Details)

Se define si es un articulo o servicio

Si

ProductID (Details)

Se define el codigo del articulo o servicio

Si

Quantity (Details)

Se define la cantidad

Si

Total (Details)

Se define el total de la linea de detalle

Si

Discount (Details)

Se define si se desea un descuento en la linea de detalle

Si

DiscountType (Details)

Se define el tipo de descuento en la linea de detalle

Si

Price (Details)

Se define el precio del articulo o servicio

Si

Comment (Details)

Se define un comentario dentro de la linea de detalle

Si

Code (ProductData)

Se define el codigo del articulo o servicio

No

Name (ProductData)

Se define el nombre del articulo o servicio

No

Unit (ProductData)

Se define la unidad de medida del articulo o servicio

No

Price (ProductData)

Se define el precio del articulo o servicio

No

Description (ProductData)

Se define una descripción del articulo o servicio

No

IsService (ProductData)

Se define si es un articulo o servicio

No

dispatchContact

Se define una glosa de contacto de despacho

No

dispatchAddress

Se define una glosa de dirección de despacho

No

dispatchDistrict

Se define una glosa de comuna de despacho

No

dispatchState

Se define una glosa de estado de despacho

No

dispatchCity

Se define una glosa de ciudad de despacho

No

dispatchCountry

Se define una glosa de Pais de despacho

No

dispatchPhone

Se define una glosa de telefono de despacho

No

comment

Se define una glosa del documento general

No

Respuesta

De retorno, en caso de haber ingresado el JSON de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "number": "string"
}
 InsertLegacyReceptionDocument

Permite ingresar un documento de recepción (solo para servicios LEGACY)

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ProviderID

Se define el ID del proveedor

Si

PurchaseOrderNumber

Se define el numero de orden de compra a recepcionar

Si

Serie

Se define la serie, si manejara enviarlo de lo contrario enviarlo en vacio

No

Comment

Se define una glosa del documento general

No

StorageCode

Se define la bodega de origen

Si

ReceptionDate

Se define la fecha de recepcion del documento

Si

Line (Detail)

Se define la linea de detalle

Si

ProductId (Detail)

Se define el codigo de articulo o servicio

Si

Quantity (Detail)

Se define la cantidad de articulos o servicios

Si

Total (Detail)

Se define el total de la linea de detalle

Si

ConceptType (Detail)

Se define el tipo de concepto

Si

IsService (Detail)

Se define si es un servicio

Si

BusinessCenter (Detail)

Se define el centro de negocio configurado para la linea de detalle

Si

Classifier01 (Detail)

Se define el clasificador 1 previamente configurador

No

classifier02 (Detail)

Se define el clasificador 1 previamente configurador

No

Comment (Detail)

Se define la glosa del documento

No

Respuesta

De retorno, en caso de haber ingresado el JSON de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "number": "string"
}
 UpdateLegacyReceptionDocument

Permite actualizar un documento de recepción (solo para servicios LEGACY)

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ProviderID

Se define el ID del proveedor

Si

PurchaseOrderNumber

Se define el numero de orden de compra a recepcionar

Si

Serie

Se define la serie, si manejara enviarlo de lo contrario enviarlo en vacio

No

Comment

Se define una glosa del documento general

No

StorageCode

Se define la bodega de origen

Si

ReceptionDate

Se define la fecha de recepcion del documento

Si

Line (Detail)

Se define la linea de detalle

Si

ProductId (Detail)

Se define el codigo de articulo o servicio

Si

Quantity (Detail)

Se define la cantidad de articulos o servicios

Si

Total (Detail)

Se define el total de la linea de detalle

Si

ConceptType (Detail)

Se define el tipo de concepto

Si

IsService (Detail)

Se define si es un servicio

Si

BusinessCenter (Detail)

Se define el centro de negocio configurado para la linea de detalle

Si

Classifier01 (Detail)

Se define el clasificador 1 previamente configurador

No

classifier02 (Detail)

Se define el clasificador 1 previamente configurador

No

Comment (Detail)

Se define la glosa del documento

No

Respuesta

De retorno, en caso de haber ingresado el JSON de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "number": "string"
}
 DeleteLegacyReceptionDocument

Permite eliminar un documento recepcionado

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Number

Numero de documento recepcionado

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "number": "string"
}
 GetConceptTypeItems

Permite obtener los tipos de conceptos de productos

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Concept

Concepto

No

ItemsPerPage

Numero de Items por pagina

Si

PageNumber

Numero de pagina (siempre empezar en 0)

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "conceptList": [
    {
      "idTipoConcepto": "string",
      "idCuenta": "string",
      "description": "string"
    }
  ]
}
 RelatePurchaseDocument

Permite relacionar un documento de compras con una orden de compra

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ProviderId

Se define el ID de proveedor

SI

OcNumber

Se define el numero de orden de compra

Si

OcSerie

Se define la serie

Si

DocumentTypeId (RelateDocuments)

Se define el código del tipo de documento a relacionar

Si

DocumentNumber (RelateDocuments)

Se define el numero de documento a relacionar

Si

Respuesta

De retorno, en caso de haber ingresado el JSON de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}

INVENTORY

 InsertDocument

Permite ingresar un documento de inventario

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application-json“

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

total

Total del movimiento

gloss

Glosa del movimiento

No

dispatchAddress

Dirección de despacho

correlative

Correlativo del movimiento

order

Orden del movimiento

isNew

Corresponde a un producto nuevo, S o N

counterExistence

Contador de existencia

intType

Tipo de entero

from

Desde

integrate

Integrado

isCentralizable

Corresponde centralizar, S o N

isProgressDisabled

El progreso del movimiento está deshabilitado, S o N

isAutoCentralizable

Si corresponde su centralización automática, S o N

isFromEdit

Si el movimiento es editable, S o N

accountingDefinitionCode

El código de la cuenta contable correspondiente a la definición de centralización

analysis

businessCenter, clasifier1, clasifier2

referenceDocumentFolio

Folio del documento de referencia

No

serial

Serie del documento de referencia

No

userId

Identificador del usuario

No

clientId

Identificador del cliente

companyId

Identificador de la empresa

sessionId

Identificador la sesión

serviceId

Identificador del servicio

fiscalYear

Año fiscal del movimiento

referenceDocumentType

Código del tipo de documento de referencia

documentTypeId

Identificador del tipo de documento

providerId

identificador del proveedor

customerId

Identificador del cliente

originStowageId

Identificador del almacenamiento de origen

destinationStowageId

Identificador del almacenamiento de destino

reasonId

Identificador del motivo

date

Fecha del movimiento

folio

Folio del movimiento

details

lote, loteExpirationDate,

lotes: batchNumber, amount, expirationDate

tasa

Tasa de la moneda del movimiento

coinId

Identificador del código

headerFileId

fileId

comment

attribute1

attribute2

attribute3

attribute4

attribute5

serialPrefix

serialSufix

serialStart

infAnCtaCtble

serials

analysis

{
"businessCenter": "string",
"clasifier1": "string",
"clasifier2": "string",
"file": "string",
"fileFieldName": "string"
}

decimals

factor

count

height

articleId

receivedCount

dispatchedCount

unitaryCount

currentCost

balance

tasaDate

serviceProjectId

summary

analysisInfo

{
"businessCenter": "string",
"clasifier1": "string",
"clasifier2": "string",
"file": "string",
"fileFieldName": "string"
}

workOrderNumber

serieOC

description

price

accountingDefinitionCode

tipoCentDet

destinationLocalization

originLocalization

length

width

orderNumber

properties

Respuesta

{
  "number": 0,
  "documentType": "string",
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 GetDocument

Permite obtener los datos de un documento de inventario

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application-json“

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

DocumentTypeId

Código de tipo de documento a consultar

No

Folio

Número del documento a consultar

No

FiscalYear

Año fiscal del documento

No

Respuesta

{
  "stockLoadOutputData": {
    "details": [
      {
        "decimals": 0,
        "lote": "string",
        "loteExpirationDate": "string",
        "lotes": [
          {
            "batchNumber": "string",
            "amount": 0,
            "expirationDate": "2021-02-04T20:26:52.909Z"
          }
        ],
        "tasa": "string",
        "coinId": "string",
        "headerFileId": "string",
        "fileId": "string",
        "factor": 0,
        "attribute1": "string",
        "attribute3": "string",
        "attribute4": "string",
        "attribute5": "string",
        "serialPrefix": "string",
        "serialSufix": "string",
        "serialStart": "string",
        "serials": [
          "string"
        ],
        "analysis": {
          "businessCenter": "string",
          "clasifier1": "string",
          "clasifier2": "string",
          "file": "string",
          "fileFieldName": "string"
        },
        "attribute2": "string",
        "count": 0,
        "height": 0,
        "width": 0,
        "articleId": "string",
        "receivedCount": 0,
        "dispatchedCount": 0,
        "unitaryCount": 0,
        "currentCost": 0,
        "balance": 0,
        "tasaDate": "2021-02-04T20:26:52.909Z",
        "serviceProjectId": "string",
        "summary": "string",
        "workOrderNumber": 0,
        "orderNumber": 0,
        "serieOC": "string",
        "description": "string",
        "price": 0,
        "accountingDefinitionCode": "string",
        "tipoCentDet": "string",
        "destinationLocalization": "string",
        "originLocalization": "string",
        "length": 0,
        "analysisInfo": {
          "businessCenter": "string",
          "clasifier1": "string",
          "clasifier2": "string",
          "file": "string",
          "fileFieldName": "string"
        },
        "properties": [
          {
            "values": [
              "string"
            ]
          }
        ],
        "productName": "string",
        "unitOfMeasurement": "string",
        "stock": 0
      }
    ],
    "company": {
      "id": "string",
      "name": "string",
      "rut": "string",
      "phone": "string",
      "rubro": 0,
      "giro": "string",
      "address": "string",
      "usesOT": true,
      "usesLotes": true,
      "usesSerial": true,
      "resolutionNumber": 0,
      "usesDispatch": true,
      "usesTransferDocument": true,
      "usesOrder": true,
      "usesBarCode": "string"
    },
    "userId": "string",
    "documentTypeId": "string",
    "documentName": "string",
    "number": 0,
    "fiscalYear": "string",
    "correlative": 0,
    "moveType": "string",
    "adjustmentMovementType": "string",
    "affectsCost": true,
    "date": "2021-02-04T20:26:52.909Z",
    "dateInput": {
      "day": 0,
      "month": 0,
      "year": 0
    },
    "clientId": {
      "priceList": "string",
      "paymentType": "string",
      "paymentTypeId": "string",
      "phones": [
        "string"
      ],
      "emails": [
        "string"
      ],
      "districts": [
        "string"
      ],
      "regions": [
        "string"
      ],
      "seller": {
        "code": "string",
        "name": "string"
      },
      "cities": [
        "string"
      ],
      "addresses": [
        "string"
      ],
      "isMiningCompany": true,
      "web": "string",
      "giro": "string",
      "name": "string",
      "rut": "string",
      "fileId": "string",
      "countries": [
        "string"
      ],
      "documentTypeId": "string"
    },
    "tClientId": {
      "id": "string",
      "country": "string"
    },
    "accountingDefinitionType": "string",
    "accountingDefinitionCode": "string",
    "businessCenterId": "string",
    "businessName": "string",
    "destinationStowageId": "string",
    "originStowageId": "string",
    "providerId": "string",
    "providerName": "string",
    "reasonId": "string",
    "referenceDocumentFolio": 0,
    "referenceDocumentType": "string",
    "dispatchAddress": "string",
    "gloss": "string",
    "analysis": {
      "businessCenter": "string",
      "clasifier1": "string",
      "clasifier2": "string",
      "file": "string",
      "fileFieldName": "string"
    },
    "state": "string",
    "reversed": "string",
    "integrate": "string",
    "infoCentralization": {
      "existencia": "string",
      "contraExistencia": "string"
    }
  },
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}

 List

Permite obtener un listado de documentos de inventario

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application-json“

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

itemsPerPage

Cantidad de resultados por página

pageNumber

Número de la página

No

documentName

Nombre del documento

documentNumber

Número del documento

No

startDate

Fecha de inicio

No

finishDate

Fecha final

No

Respuesta

{
  "data": {
    "draw": 0,
    "recordsTotal": 0,
    "recordsFiltered": 0,
    "data": [
      {
        "folio": 0,
        "correlative": 0,
        "date": "string",
        "realDate": "2021-02-04T20:29:52.121Z",
        "documentTypeId": "string",
        "documentTypeName": "string",
        "originStowageId": "string",
        "destinationStowageId": "string",
        "total": "string",
        "tipoMov": "string",
        "consistent": "string",
        "status": "string",
        "fiscalYear": "string",
        "voucherStatus": "string",
        "voucherType": "string",
        "voucherFiscalYear": "string",
        "voucherFolio": 0,
        "voucherFolioProperty": 0,
        "isDispatchGuide": true,
        "isOpeningMovement": "string",
        "debit": "string",
        "credit": "string",
        "reversed": "string",
        "statusApproved": "string",
        "totalRows": 0,
        "origin": "string"
      }
    ],
    "error": "string"
  },
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}

 GetBatchesInfo

Permite obtener la información de los lotes de la empresa.

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

batchNumber

Número de lote a consultar

productID

Código del artículo a consultar

storageID

Código de la bodega a consultar

itemsPerPage

Items por página

pageNumber

Número de página (inicia en 0)

Respuesta

{
  "success": true,
  "message": "string",
  "totalItems": 0,
  "pageNumber": 0,
  "itemsPerPage": 0,
  "productDetail": [
    {
      "active": "string",
      "code": "string",
      "externalCode": "string",
      "internalCode": "string",
      "name": "string",
      "detailedDescription": "string",
      "companyID": "string",
      "coinID": "string",
      "sellPrice": 0,
      "stock": 0,
      "type": "string",
      "unit": "string",
      "imptoAd": "string",
      "idImptoAd": "string",
      "usesLotes": true,
      "usesSeries": true,
      "storageDetail": [
        {
          "storageID": "string",
          "stock": 0,
          "batchDetail": [
            {
              "batchNumber": "string",
              "stock": 0,
              "expirationDate": "2021-04-12T16:33:36.133Z",
              "storageID": "string"
            }
          ]
        }
      ]
    }
  ]
}
 Insert

Permite ingresar un documento de inventario (metodo simplificado)

Ambientes

Verbo HTTP: PUT

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(no aplica)

Respuesta

{
  "folio": 0,
  "documentTypeId": "string",
  "fiscalYear": "string",
  "clientId": "string",
  "providerId": "string",
  "gloss": "string",
  "originStowageId": "string",
  "destinationStowageId": "string",
  "reasonId": "string",
  "total": 0,
  "isCentralizable": true,
  "analysis": {
    "businessCenter": "string",
    "clasifier1": "string",
    "clasifier2": "string",
    "file": "string",
    "fileFieldName": "string"
  },
  "referenceDocumentFolio": 0,
  "referenceDocumentType": "string",
  "date": "2021-12-14T20:25:24.634Z",
  "externalDocumentID": "string",
  "details": [
    {
      "articleId": "string",
      "description": "string",
      "count": 0,
      "coinId": "string",
      "comment": "string",
      "price": 0,
      "serialPrefix": "string",
      "serialSufix": "string",
      "serialStart": "string",
      "serials": [
        "string"
      ],
      "lotes": [
        {
          "batchNumber": "string",
          "amount": 0,
          "expirationDate": "2021-12-14T20:25:24.634Z"
        }
      ],
      "analysis": {
        "businessCenter": "string",
        "clasifier1": "string",
        "clasifier2": "string",
        "file": "string",
        "fileFieldName": "string"
      },
      "ocDetails": {
        "number": 0,
        "serie": "string",
        "line": 0
      }
    }
  ]
}
 Delete

Permite eliminar los datos de un documento de inventario

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

DocumentTypeId

Código de tipo de documento

Folio

Número del documento a consultar

FiscalYear

Año fiscal del documento

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 UpdateDocument

Permite modificar un documento de inventario

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(no aplica)

Respuesta

{
  "folio": 0,
  "documentTypeId": "string",
  "fiscalYear": "string",
  "clientId": "string",
  "providerId": "string",
  "gloss": "string",
  "originStowageId": "string",
  "destinationStowageId": "string",
  "reasonId": "string",
  "total": 0,
  "isCentralizable": true,
  "analysis": {
    "businessCenter": "string",
    "clasifier1": "string",
    "clasifier2": "string",
    "file": "string",
    "fileFieldName": "string"
  },
  "referenceDocumentFolio": 0,
  "referenceDocumentType": "string",
  "date": "2021-12-15T12:46:29.357Z",
  "externalDocumentID": "string",
  "details": [
    {
      "articleId": "string",
      "description": "string",
      "count": 0,
      "comment": "string",
      "price": 0,
      "serialPrefix": "string",
      "serialSufix": "string",
      "serialStart": "string",
      "serials": [
        "string"
      ],
      "lotes": [
        {
          "batchNumber": "string",
          "amount": 0,
          "expirationDate": "2021-12-15T12:46:29.357Z"
        }
      ],
      "analysis": {
        "businessCenter": "string",
        "clasifier1": "string",
        "clasifier2": "string",
        "file": "string",
        "fileFieldName": "string"
      }
    }
  ]
}
 GetDocumentByExternalDocumentID

Permite obtener los datos de un documento de inventario a través de su ID de documento externo

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ExternalDocumentID

ID de documento externo a consultar

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "stockLoadOutputData": {
    "company": {
      "id": "string",
      "name": "string",
      "rut": "string",
      "phone": "string",
      "rubro": 0,
      "giro": "string",
      "address": "string",
      "usesOT": true,
      "usesLotes": true,
      "usesSerial": true,
      "resolutionNumber": 0,
      "usesDispatch": true,
      "usesTransferDocument": true,
      "usesOrder": true,
      "usesBarCode": "string"
    },
    "userId": "string",
    "documentTypeId": "string",
    "documentName": "string",
    "number": 0,
    "fiscalYear": "string",
    "correlative": 0,
    "moveType": "string",
    "adjustmentMovementType": "string",
    "affectsCost": true,
    "date": "2021-12-15T12:50:38.565Z",
    "dateInput": {
      "day": 0,
      "month": 0,
      "year": 0
    },
    "clientId": {
      "priceList": "string",
      "paymentType": "string",
      "paymentTypeId": "string",
      "phones": [
        "string"
      ],
      "emails": [
        "string"
      ],
      "districts": [
        "string"
      ],
      "regions": [
        "string"
      ],
      "seller": {
        "code": "string",
        "name": "string"
      },
      "cities": [
        "string"
      ],
      "addresses": [
        "string"
      ],
      "isMiningCompany": true,
      "web": "string",
      "giro": "string",
      "name": "string",
      "rut": "string",
      "fileId": "string",
      "countries": [
        "string"
      ],
      "documentTypeId": "string"
    },
    "tClientId": {
      "id": "string",
      "country": "string"
    },
    "accountingDefinitionType": "string",
    "accountingDefinitionCode": "string",
    "businessCenterId": "string",
    "businessName": "string",
    "destinationStowageId": "string",
    "originStowageId": "string",
    "providerId": "string",
    "providerName": "string",
    "reasonId": "string",
    "referenceDocumentFolio": 0,
    "referenceDocumentType": "string",
    "dispatchAddress": "string",
    "gloss": "string",
    "details": [
      {
        "decimals": 0,
        "lote": "string",
        "loteExpirationDate": "string",
        "lotes": [
          {
            "batchNumber": "string",
            "amount": 0,
            "expirationDate": "2021-12-15T12:50:38.566Z"
          }
        ],
        "tasa": "string",
        "coinId": "string",
        "headerFileId": "string",
        "fileId": "string",
        "factor": 0,
        "attribute1": "string",
        "attribute3": "string",
        "attribute4": "string",
        "attribute5": "string",
        "serialPrefix": "string",
        "serialSufix": "string",
        "serialStart": "string",
        "serials": [
          "string"
        ],
        "analysis": {
          "businessCenter": "string",
          "clasifier1": "string",
          "clasifier2": "string",
          "file": "string",
          "fileFieldName": "string"
        },
        "attribute2": "string",
        "count": 0,
        "height": 0,
        "width": 0,
        "articleId": "string",
        "receivedCount": 0,
        "dispatchedCount": 0,
        "unitaryCount": 0,
        "currentCost": 0,
        "balance": 0,
        "tasaDate": "2021-12-15T12:50:38.566Z",
        "serviceProjectId": "string",
        "summary": "string",
        "workOrderNumber": 0,
        "orderNumber": 0,
        "serieOC": "string",
        "description": "string",
        "price": 0,
        "accountingDefinitionCode": "string",
        "tipoCentDet": "string",
        "destinationLocalization": "string",
        "originLocalization": "string",
        "length": 0,
        "analysisInfo": {
          "businessCenter": "string",
          "clasifier1": "string",
          "clasifier2": "string",
          "file": "string",
          "fileFieldName": "string"
        },
        "properties": [
          {
            "values": [
              "string"
            ]
          }
        ],
        "productName": "string",
        "unitOfMeasurement": "string",
        "stock": 0
      }
    ],
    "analysis": {
      "businessCenter": "string",
      "clasifier1": "string",
      "clasifier2": "string",
      "file": "string",
      "fileFieldName": "string"
    },
    "state": "string",
    "reversed": "string",
    "integrate": "string",
    "infoCentralization": {
      "existencia": "string",
      "contraExistencia": "string"
    }
  }
}
 GetFutureStockInfo

Permite obtener información sobre el stock futuro de los productos de una empresa

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campos

Descripción

Requerido

ItemsPerPage

Ítems por página

Page

Número de página

ProductCode

Código del producto

No

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "productsDetail": [
    {
      "productCode": "string",
      "description": "string",
      "currentStock": 0,
      "reservedStock": 0,
      "stockToReceive": 0,
      "futureStock": 0,
      "storageInfo": [
        {
          "storageCode": "string",
          "productCode": "string",
          "currentStock": 0,
          "reservedStock": 0,
          "maximumStockToReceive": 0,
          "maximumFutureStock": 0,
          "minimumFutureStock": 0
        }
      ]
    }
  ],
  "page": 0,
  "itemsPerPage": 0,
  "totalItems": 0
}
 GetModifiedDocuments

Permite obtener los documentos de inventario modificados para las empresas suscritas

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campos

Descripción

Requerido

FromDate

Numero de Lote

No

ToDate

Código de Articulo

No

ItemsPerPage

Ítems por página

No

PageNumber

Numero de Pagina

No

Respuesta

De retorno, en caso de haber ingresado los datos de acceso en forma correcta, nos aparecerá un mensaje similar al siguiente

{
  "success": true,
  "message": "string",
  "itemsPerPage": 0,
  "pageNumber": 0,
  "totalItems": 0,
  "exceptionMessage": "string",
  "documents": [
    {
      "fiscalYear": "string",
      "documentType": "string",
      "number": 0,
      "timeStamp": "2023-03-02T01:15:52.491Z",
      "modifiedDocuments": [
        {
          "fiscalYear": "string",
          "documentType": "string",
          "number": 0
        }
      ]
    }
  ]
}

DISPATCH

 InsertDocument

Permite ingresar guías de despacho (método no recomendado)

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

action

userId

clientId

companyId

sessionId

serviceId

shopId

clientFileId

sellerFileId

documentTypeId

paymentConditionId

priceListId

contactId

giro

district

billingCoinId

billingRate

incomeCoinId

incomeRate

contactIndex

gloss

creditDebitNoteType

realCreditDebitNoteType

serie

serieAlfa

firstFolio

lastFolio

isTransferDocument

dispatchType

assetsType

transactionType

originStorage

code, motive,

analysis: accountNumber, file, businessCenter, classifier01, classifier02, nameTypeInv

destinationStorage

code, motive,

analysis: accountNumber, file, businessCenter, classifier01, classifier02, nameTypeInv

isTransferDispatch

clientAnalysis

accountNumber, file, businessCenter, classifier01, classifier02, nameTypeInv

firstFeePaid

day, month, year

dueDate

day, month, year

emissionDate

day, month, year

exportData

transportWay, destinationCountry, destinationMerchandise, salesMode, paymentMethod, serviceIndicator, saleClause, totalClause, shipmentPort, landingPort,

tareMeasure: value, unit

weight: value, unit

package: value, unit

grossWeight: value, unit

(details)

stockData

lotes: batchNumber, amount, expirationDate

(details)

serials

serialStart, serialSufix, serialPrefix, destinationLocalization

(details)

analysis

accountNumber, file, businessCenter, classifier01, classifier02, nameTypeInv

(details)

analysisInv

accountNumber, file, businessCenter, classifier01, classifier02, nameTypeInv

(details)

type

(details)

isExempt

(details)

code

(details)

count

(details)

price

(details)

comment

(details)

attachedLine

(details)

attachedFolio

(details)

tax

code, value

(details)

discount

type, value

(details)

taxes

analysis: accountNumber, file, businessCenter, classifier01, classifier02, nameTypeInv

code, value

(details)

modifiers

type, value, class, percentage, name, number, amount

attachedDocuments

documentTypeId, folio, reason,

date: day, month, year

documentTypeCode

customFields

id, name, value

Respuesta

{
  "firstFolio": 0,
  "lastFolio": 0,
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 Save

Permite ingresar guías de despacho (método recomendado)

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

documentType

firstFolio

lastFolio

externalDocumentID

emissionDate

day, month, year

firstFeePaid

day, month, year

clientFile

contactIndex

paymentCondition

sellerFileId

clientAnalysis

accountNumber, businessCenter, classifier01, classifier02, nameTypeInv

billingCoin

billingRate

shopId

priceList

giro

district

city

contact

attachedDocuments

date: day, month, year

documentTypeId, folio, reason

originStorage

code, motive

storageAnalysis: accountNumber, businessCenter, classifier01, classifier02

destinationStorage

code, motive

storageAnalysis: accountNumber, businessCenter, classifier01, classifier02

dispatchInfo

assetsType, dispatchType, transactionType, isTransferDispatch

(details)

type

(details)

isExempt

(details)

code

(details)

count

(details)

productName

(details)

productNameBarCode

(details)

price

(details)

unit

(details)

analysis

accountNumber, businessCenter, classifier01, classifier02

(details)

useBatch

(details)

batchInfo

amount, batchNumber

saleTaxes

code, value

taxAnalysis: accountNumber, businessCenter, classifier01, classifier02

ventaRecDesGlobal

amount, modifierClass, name, percentage, value

gloss

isTransferDocument

Respuesta

{
  "success": true,
  "firstFolio": 0,
  "lastFolio": 0,
  "message": "string"
}
 SaveAsyncStockMovement

Permite ingresar guías de despacho, generando en forma asíncrona (y sin manejo de errores) su documento de inventario

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

documentType

firstFolio

lastFolio

externalDocumentID

emissionDate

day, month, year

firstFeePaid

day, month, year

clientFile

contactIndex

paymentCondition

sellerFileId

clientAnalysis

accountNumber, businessCenter, classifier01, classifier02

billingCoin

billingRate

shopId

priceList

giro

district

city

contact

attachedDocuments

date: day, month, year

documentTypeId

folio

reason

originStorage

code, motive,

storageAnalysis: accountNumber, businessCenter, classifier01, classifier02

destinationStorage

code, motive,

storageAnalysis: accountNumber, businessCenter, classifier01, classifier02

dispatchInfo

assetsType, dispatchType, transactionType, isTransferDispatch

(details)

type

(details)

isExempt

(details)

code

(details)

count

(details)

productName

(details)

productNameBarCode

(details)

price

(details)

unit

(details)

analysis

accountNumber, businessCenter, classifier01, classifier02

(details)

useBatch

(details)

batchInfo

amount, batchNumber

(saleTaxes)

code

(saleTaxes)

value

(saleTaxes)

taxAnalysis

accountNumber, businessCenter, classifier01, classifier02

(ventaRecDesGlobal)

amount

(ventaRecDesGlobal)

modifierClass

(ventaRecDesGlobal)

name

(ventaRecDesGlobal)

percentage

(ventaRecDesGlobal)

value

gloss

isTransferDocument

Respuesta

{
  "success": true,
  "firstFolio": 0,
  "lastFolio": 0,
  "message": "string"
}

ORDER

 Get

Permite consultar información sobre un pedido

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

number

Número de pedido

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "orderData": {
    "documentTypeID": "string",
    "number": 0,
    "client": {
      "fileId": "string",
      "legalCode": "string",
      "name": "string",
      "giro": "string",
      "address": "string",
      "country": "string",
      "city": "string",
      "region": "string",
      "district": "string",
      "email": "string",
      "phone": "string"
    },
    "creationDate": "2021-05-20T19:35:47.933Z",
    "shopID": "string",
    "billingCoindID": "string",
    "billingRate": 0,
    "sellerID": "string",
    "expirationDate": "2021-05-20T19:35:47.933Z",
    "comment": "string",
    "billingComment": "string",
    "dispatchComment": "string",
    "details": [
      {
        "total": 0,
        "discountType": "string",
        "discountValue": 0,
        "isExempt": true,
        "detailedDescription": "string",
        "comment": "string",
        "count": 0,
        "unit": "string",
        "name": "string",
        "code": "string",
        "isService": true,
        "price": 0
      }
    ],
    "modifiers": [
      {
        "name": "string",
        "class": "string",
        "number": 0,
        "value": 0,
        "percentage": 0
      }
    ],
    "taxes": [
      {
        "name": "string",
        "symbol": "string",
        "percentage": 0,
        "code": "string",
        "value": 0
      }
    ],
    "totals": {
      "exempt": 0,
      "affectable": 0,
      "linealDiscount": 0,
      "linealSurcharge": 0,
      "totalWithoutLinealDiscount": 0,
      "totalDiscountSurcharge": 0,
      "total": 0
    }
  }
}
 List

Permite consultar un listado de pedidos

Ambientes

Verbo HTTP: Get

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

FromDate

Fecha desde la cual se consultarán resultados

ToDate

Fecha hasta la cual se consultarán resultados

ItemsPerPage

Cantidad de resultados por página

Página a consultar (comienza en 0)

Página a consultar (comienza en 0)

fromNumber

Número desde el cual consultar pedidos (opcional)

No

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "items": [
    {
      "number": 0,
      "creationDate": "2021-05-20T19:47:29.743Z",
      "clientFileId": "string"
    }
  ]
}
 SaveOrder

Permite guardar pedidos asociados a la empresa.

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

DocumentTypeId

Código del tipo de documento

Number

Numero de documento (Enviar en 0 para que tome el correlativo)

Si

PricingId

Numero de cotización a asociar al pedido

No

ClientFileId

Código de ID ficha del cliente

Si

SellerFileId

Código de vendedor

Si

PaymentConditionId

Código de tipo de condición de pago

Si

BillingCoinId

Código de ID de moneda a utilizar

Si

BillingRate

Código de Cambio de Moneda

Si

ShopId

Código de ID de local

Si

PriceListId

Código de lista de precio

Si

BillingType

Código de tipo de facturación

No

Giro

Giro del documento

Si

District

Código de ID de comuna

Si

Type (OrderDetail)

Tipo de producto (Puede ser “A“ si es articulo o “S“ si es servicio)

Si

IsExempt (OrderDetail)

Se define si la linea de detalle es exento o no

Si

IsService (OrderDetail)

Se define si es un servicio o no

Si

Code (OrderDetail)

Código del articulo o servicio

Si

Unit (OrderDetail)

Código de la unidad de medida

Si

Count (OrderDetail)

Cantidad de articulo o servicio

Si

Price (OrderDetail)

El precio del articulo o servicio

Si

DeliveryTime (OrderDetail)

La hora de delivery

No

Hour (DeliveryTime)

Hora de delivery

No

Minute (DeliveryTime)

Minuto de delivery

No

Discount (OrderDetail)

Se define un descuento en la linea de detalle

No

value (Discount)

Se define el monto del descuento

No

Type (Discount)

Se define si es monto fijo (enviar 0) o monto porcentaje (enviar 1)

No

Tax (OrderDetail)

Se define el impuesto de la linea de detalle

Si

Value (Tax)

Se define el porcentaje de descuento de la linea de detalle

Si

Type (Tax)

Se define el código del impuesto de la linea de detalle

Si

Comment (OrderDetail)

Se define un comentario dentro de la linea de detalle

Si

ProductName (OrderDetail)

Se define el nombre del articulo

Si

DeliveryDate (OrderDetail)

Se define la fecha de delivery

No

Day (DeliveryDate)

Se define el día del delivery

No

Month (DeliveryDate)

Se define el mes del delivery

No

Year (DeliveryDate)

Se define el año del delivery

No

Taxes

Se define el impuesto del documento

Si

Code (Taxes)

Se define el codigo del impuesto

Si

Value (Taxes)

Se define el valor del impuesto

Si

CreationDate

Se define la fecha de la creacion del documento

Si

day (CreationDate)

Se define el dia de la fecha de creacion

Si

Month (CreationDate)

Se define el mes de la fecha de creacion

Si

Year (CreationDate)

Se define el año de la fecha de creacion

Si

ExpirationDate

Se define la fecha de expiracion del documento

Si

day (ExpirationDate)

Se define el dia de la fecha de expiracion

Si

Month (ExpirationDate)

Se define el mes de la fecha de expiracion

Si

Year (ExpirationDate)

Se define el año de la fecha de expiracion

Si

GlossGeneral

Se define un comentario del documento

No

GlossDispatch

Se define un comentario de despacho del documento

No

GlossBill

Se define un comentario de facturacion del documento

No

GlossPresentation

Se define un comentario de presentacion

No

Respuesta

{
  "documentTypeId": "string",
  "number": 0,
  "pricingId": "string",
  "clientFileId": "string",
  "sellerFileId": "string",
  "paymentConditionId": "string",
  "billingCoinId": "string",
  "billingRate": 0,
  "shopId": "string",
  "priceListId": "string",
  "billingType": "string",
  "giro": "string",
  "district": "string",
  "orderDetails": [
    {
      "type": "string",
      "isExempt": true,
      "isService": true,
      "code": "string",
      "unit": "string",
      "count": 0,
      "price": 0,
      "deliveryTime": {
        "hour": 0,
        "minute": 0
      },
      "discount": {
        "value": 0,
        "type": 0
      },
      "tax": {
        "value": 0,
        "code": "string"
      },
      "comment": "string",
      "productName": "string",
      "deliveryDate": {
        "day": 0,
        "month": 0,
        "year": 0
      }
    }
  ],
  "taxes": [
    {
      "code": "string",
      "value": 0
    }
  ],
  "creationDate": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "expirationDate": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "glossGeneral": "string",
  "glossDispatch": "string",
  "glossBill": "string",
  "glossPresentation": "string"
}
 ApproveCommercially

Permite aprobar comercialmente un pedido

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

OrderNumber

Número del pedido

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 DispatchOrder

Permite generar una guia de despacho asociada a un pedido

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(no aplica)

Respuesta

{
  "orderNumber": 0,
  "clientAnalysis": {
    "accountNumber": "string",
    "businessCenter": "string",
    "classifier01": "string",
    "classifier02": "string"
  },
  "emissionDate": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "firstFeePaid": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "dispatchInfo": {
    "assetsType": "string",
    "dispatchType": "string",
    "transactionType": "string",
    "isTransferDispatch": true
  },
  "originStorageInfo": {
    "code": "string",
    "motive": "string",
    "storageAnalysis": {
      "accountNumber": "string",
      "businessCenter": "string",
      "classifier01": "string",
      "classifier02": "string"
    }
  },
  "destinationStorageInfo": {
    "code": "string",
    "motive": "string",
    "storageAnalysis": {
      "accountNumber": "string",
      "businessCenter": "string",
      "classifier01": "string",
      "classifier02": "string"
    }
  },
  "orderDetailAnalysis": [
    {
      "line": 0,
      "isExempt": true,
      "discount": {
        "type": 0,
        "value": 0
      },
      "detailAnalysis": {
        "accountNumber": "string",
        "businessCenter": "string",
        "classifier01": "string",
        "classifier02": "string"
      }
    }
  ],
  "dispatchTaxes": [
    {
      "code": "string",
      "value": 0,
      "taxAnalysis": {
        "accountNumber": "string",
        "businessCenter": "string",
        "classifier01": "string",
        "classifier02": "string"
      }
    }
  ],
  "gloss": "string",
  "isTransferDocument": true
}

{
  "orderNumber": 0,
  "clientAnalysis": {
    "accountNumber": "string",
    "businessCenter": "string",
    "classifier01": "string",
    "classifier02": "string"
  },
  "emissionDate": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "firstFeePaid": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "dispatchInfo": {
    "assetsType": "string",
    "dispatchType": "string",
    "transactionType": "string",
    "isTransferDispatch": true
  },
  "originStorageInfo": {
    "code": "string",
    "motive": "string",
    "storageAnalysis": {
      "accountNumber": "string",
      "businessCenter": "string",
      "classifier01": "string",
      "classifier02": "string"
    }
  },
  "destinationStorageInfo": {
    "code": "string",
    "motive": "string",
    "storageAnalysis": {
      "accountNumber": "string",
      "businessCenter": "string",
      "classifier01": "string",
      "classifier02": "string"
    }
  },
  "orderDetailAnalysis": [
    {
      "line": 0,
      "isExempt": true,
      "discount": {
        "type": 0,
        "value": 0
      },
      "detailAnalysis": {
        "accountNumber": "string",
        "businessCenter": "string",
        "classifier01": "string",
        "classifier02": "string"
      }
    }
  ],
  "dispatchTaxes": [
    {
      "code": "string",
      "value": 0,
      "taxAnalysis": {
        "accountNumber": "string",
        "businessCenter": "string",
        "classifier01": "string",
        "classifier02": "string"
      }
    }
  ],
  "gloss": "string",
  "isTransferDocument": true
}
 ApproveFinancially

Permite aprobar financieramente un pedido

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

OrderNumber

Número del pedido

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 InvoiceOrder

Permite facturar un pedido despachado previamente

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(no aplica)

Respuesta

{
  "orderNumber": 0,
  "documentId": "string",
  "externalDocumentID": "string",
  "clientAnalysis": {
    "accountNumber": "string",
    "businessCenter": "string",
    "classifier01": "string",
    "classifier02": "string"
  },
  "emissionDate": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "firstFeePaid": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "orderDetailAnalysis": [
    {
      "line": 0,
      "isExempt": true,
      "discount": {
        "type": 0,
        "value": 0
      },
      "detailAnalysis": {
        "accountNumber": "string",
        "businessCenter": "string",
        "classifier01": "string",
        "classifier02": "string"
      }
    }
  ],
  "invoiceTaxes": [
    {
      "code": "string",
      "value": 0,
      "taxAnalysis": {
        "accountNumber": "string",
        "businessCenter": "string",
        "classifier01": "string",
        "classifier02": "string"
      }
    }
  ],
  "gloss": "string",
  "isTransferDocument": true
}
 Delete

Permite eliminar un pedido ingresado

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Number

Número del pedido

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "folio": "string"
}
 UpdateOrder

Permite modificar un pedido guardado exitosamente

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

DocumentTypeId

Código del tipo de documento

Number

Numero de documento (Enviar en 0 para que tome el correlativo)

Si

PricingId

Numero de cotización a asociar al pedido

No

ClientFileId

Código de ID ficha del cliente

Si

SellerFileId

Código de vendedor

Si

PaymentConditionId

Código de tipo de condición de pago

Si

BillingCoinId

Código de ID de moneda a utilizar

Si

BillingRate

Código de Cambio de Moneda

Si

ShopId

Código de ID de local

Si

PriceListId

Código de lista de precio

Si

BillingType

Código de tipo de facturación

No

Giro

Giro del documento

Si

District

Código de ID de comuna

Si

Type (OrderDetail)

Tipo de producto (Puede ser “A“ si es articulo o “S“ si es servicio)

Si

IsExempt (OrderDetail)

Se define si la linea de detalle es exento o no

Si

IsService (OrderDetail)

Se define si es un servicio o no

Si

Code (OrderDetail)

Código del articulo o servicio

Si

Unit (OrderDetail)

Código de la unidad de medida

Si

Count (OrderDetail)

Cantidad de articulo o servicio

Si

Price (OrderDetail)

El precio del articulo o servicio

Si

DeliveryTime (OrderDetail)

La hora de delivery

No

Hour (DeliveryTime)

Hora de delivery

No

Minute (DeliveryTime)

Minuto de delivery

No

Discount (OrderDetail)

Se define un descuento en la linea de detalle

No

value (Discount)

Se define el monto del descuento

No

Type (Discount)

Se define si es monto fijo (enviar 0) o monto porcentaje (enviar 1)

No

Tax (OrderDetail)

Se define el impuesto de la linea de detalle

Si

Value (Tax)

Se define el porcentaje de descuento de la linea de detalle

Si

Type (Tax)

Se define el código del impuesto de la linea de detalle

Si

Comment (OrderDetail)

Se define un comentario dentro de la linea de detalle

Si

ProductName (OrderDetail)

Se define el nombre del articulo

Si

DeliveryDate (OrderDetail)

Se define la fecha de delivery

No

Day (DeliveryDate)

Se define el día del delivery

No

Month (DeliveryDate)

Se define el mes del delivery

No

Year (DeliveryDate)

Se define el año del delivery

No

Taxes

Se define el impuesto del documento

Si

Code (Taxes)

Se define el codigo del impuesto

Si

Value (Taxes)

Se define el valor del impuesto

Si

CreationDate

Se define la fecha de la creacion del documento

Si

day (CreationDate)

Se define el dia de la fecha de creacion

Si

Month (CreationDate)

Se define el mes de la fecha de creacion

Si

Year (CreationDate)

Se define el año de la fecha de creacion

Si

ExpirationDate

Se define la fecha de expiracion del documento

Si

day (ExpirationDate)

Se define el dia de la fecha de expiracion

Si

Month (ExpirationDate)

Se define el mes de la fecha de expiracion

Si

Year (ExpirationDate)

Se define el año de la fecha de expiracion

Si

GlossGeneral

Se define un comentario del documento

No

GlossDispatch

Se define un comentario de despacho del documento

No

GlossBill

Se define un comentario de facturacion del documento

No

GlossPresentation

Se define un comentario de presentacion

No

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "documentTypeId": "string",
  "number": 0,
  "pricingId": "string",
  "clientFileId": "string",
  "sellerFileId": "string",
  "paymentConditionId": "string",
  "billingCoinId": "string",
  "billingRate": 0,
  "shopId": "string",
  "priceListId": "string",
  "billingType": "string",
  "giro": "string",
  "district": "string",
  "orderDetails": [
    {
      "type": "string",
      "isExempt": true,
      "isService": true,
      "code": "string",
      "unit": "string",
      "count": 0,
      "price": 0,
      "deliveryTime": {
        "hour": 0,
        "minute": 0
      },
      "discount": {
        "value": 0,
        "type": 0
      },
      "tax": {
        "value": 0,
        "code": "string"
      },
      "comment": "string",
      "productName": "string",
      "deliveryDate": {
        "day": 0,
        "month": 0,
        "year": 0
      }
    }
  ],
  "taxes": [
    {
      "code": "string",
      "value": 0
    }
  ],
  "creationDate": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "expirationDate": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "glossGeneral": "string",
  "glossDispatch": "string",
  "glossBill": "string",
  "glossPresentation": "string"
}
 GetOrderStandardPDFDocumentBase64

Permite obtener el base64 del PDF de un pedido, en un formato de impresión estándar

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Folio

Número del pedido

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "document": "string"
}
 GetAssociatedPurchaseOrder

Permite obtener las ordenes de compra asociado a un pedido

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Numero

Número del pedido

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "purchaseOrderList": [
    {
      "number": "string"
    }
  ]
}

PRICING

 SavePricing

Permite guardar cotizaciones asociadas a la empresa.

Ambiente

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

(no aplica)

Respuesta

{
  "clientFileId": "string",
  "sellerFileId": "string",
  "documentTypeId": "string",
  "paymentConditionId": "string",
  "priceListId": "string",
  "giro": "string",
  "district": "string",
  "billingCoinId": "string",
  "billingRate": 0,
  "gloss": "string",
  "description": "string",
  "folio": 0,
  "templateId": 0,
  "closingProbability": "string",
  "emissionDate": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "dueDate": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "closingDate": {
    "day": 0,
    "month": 0,
    "year": 0
  },
  "details": [
    {
      "isService": true,
      "isExempt": true,
      "code": "string",
      "type": "string",
      "unit": "string",
      "count": 0,
      "price": 0,
      "comment": "string",
      "discount": {
        "type": 0,
        "value": 0
      },
      "deliveryDate": {
        "day": 0,
        "month": 0,
        "year": 0
      },
      "deliveryDateInput": "2021-12-16T16:15:02.780Z"
    }
  ],
  "taxes": [
    {
      "code": "string",
      "value": 0
    }
  ],
  "modifiers": [
    {
      "type": 0,
      "value": 0,
      "class": "string",
      "percentage": 0,
      "name": "string",
      "number": 0,
      "amount": 0
    }
  ],
  "customFields": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "isTemplate": true
}
 GetPricing

Permite consultar los detalles de una cotización

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Number

Número de la cotización

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "pricingData": {
    "documentType": "string",
    "clientId": "string",
    "priceListId": "string",
    "gloss": "string",
    "billingCoinId": "string",
    "billingRate": 0,
    "contactId": 0,
    "sellerFileId": "string",
    "paymentCondition": "string",
    "state": "string",
    "folio": 0,
    "templateId": 0,
    "closingProbability": "string",
    "dueDate": "2021-12-20T14:33:59.564Z",
    "pricingDate": "2021-12-20T14:33:59.564Z",
    "closingDate": "2021-12-20T14:33:59.564Z",
    "details": [
      {
        "code": "string",
        "type": "string",
        "unit": "string",
        "count": 0,
        "price": 0,
        "comment": "string",
        "discount": {
          "type": "string",
          "value": 0
        },
        "deliveryDate": "2021-12-20T14:33:59.564Z",
        "total": 0,
        "idDetailGroup": 0
      }
    ],
    "taxes": [
      {
        "taxeCode1": "string",
        "taxePercentaje1": 0,
        "taxeValue1": 0,
        "taxeCode2": "string",
        "taxePercentaje2": 0,
        "taxeValue2": 0,
        "taxeCode3": "string",
        "taxePercentaje3": 0,
        "taxeValue3": 0,
        "taxeCode4": "string",
        "taxePercentaje4": 0,
        "taxeValue4": 0,
        "taxeCode5": "string",
        "taxePercentaje5": 0,
        "taxeValue5": 0
      }
    ],
    "customFields": [
      {
        "id": 0,
        "name": "string",
        "value": "string"
      }
    ],
    "totals": [
      {
        "exempt": 0,
        "affectable": 0,
        "totalDiscountSurcharge": 0,
        "total": 0,
        "subTotal": 0
      }
    ]
  }
}
 List

Permite consultar un listado de cotizaciones

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Deswcripción

Requerido

FromDate

Fecha desde la cual se consultarán resultados

ToDate

Fecha hasta la cual se consultarán resultados

ItemsPerPage

Cantidad de resultados por página

PageNumber

Página a consultar (comienza en 0)

fromNumber

Número desde el cual consultar cotización (opcional)

No

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "items": [
    {
      "number": 0,
      "documentTypeID": "string",
      "pricingDate": "2021-12-20T14:37:40.948Z",
      "clientFileId": "string"
    }
  ]
}

PURCHASE

 List

Permite consultar un listado de documentos de compra de la empresa

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

StartDate

Filtro de fecha de inicio

FinishDate

Filtro de fecha de término

ItemsPerPage

Elementos por página (recomendado 10)

Page

Página a consultar (comienza en 0)

SiiDocumentCode

Código de documento del SII (33, 34...)

No

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "data": {
    "draw": 0,
    "recordsTotal": 0,
    "recordsFiltered": 0,
    "data": [
      {
        "origin": 1,
        "companyId": "string",
        "providerLegalCode": "string",
        "providerName": "string",
        "documentNumber": "string",
        "documentType": "string",
        "documentTotal": "string",
        "documentEmissionDate": "2021-12-17T13:39:57.895Z",
        "documentEntryType": 0,
        "documentPlatformId": "string",
        "siiReceiptDate": "2021-12-17T13:39:57.895Z",
        "lastStatus": "string",
        "isIntegrated": true,
        "isDigital": true,
        "isReceived": true,
        "providerId": "string",
        "siiDocumentType": "string",
        "documentTypeId": "string",
        "fiscalYear": "string",
        "voucherTypeId": "string",
        "voucherNumber": 0,
        "accoutingBalance": 0,
        "key": "string",
        "canEdit": true,
        "canRemove": true,
        "deleteFailCondition": "string",
        "canFix": true,
        "canCancel": true,
        "canReceive": true,
        "canReject": true,
        "canLey19983": true,
        "canGenericView": true,
        "canPreview": true,
        "canPrint": true,
        "canReceipt": true,
        "hasStockDocumentsRelated": true,
        "hasMenu": true,
        "originDescription": "string"
      }
    ],
    "error": "string"
  }
}
 Get

Permite obtener los detalles de un documento de compra

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Provider

Código del proveedor

DocumentType

Código del documento

Number

Número del documento

Respuesta

De retorno, en caso de haber ingresado los parametros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "data": {
    "company": {
      "id": "string",
      "name": "string",
      "rut": "string",
      "phone": "string",
      "rubro": 0,
      "giro": "string",
      "address": "string",
      "district": "string",
      "usesOT": true,
      "usesLotes": true,
      "usesSerial": true,
      "resolutionNumber": 0,
      "usesDispatch": true,
      "usesTransferDocument": true,
      "usesOrder": true,
      "usesBarCode": "string"
    },
    "providerId": "string",
    "provider": {
      "file": {
        "id": "string",
        "companyId": "string",
        "isClient": true,
        "isProvider": true,
        "isEmployee": true,
        "isPerson": true,
        "legalCode": "string",
        "name": "string",
        "lastName1": "string",
        "lastName2": "string",
        "nickname": "string",
        "business": "string",
        "initials": "string",
        "postalBox": "string",
        "zipCode": "string",
        "webSite": "string",
        "rubroId": "string",
        "companyType": "string",
        "priceList": "string",
        "sellerFileId": "string",
        "paymentType": "string"
      },
      "analysis": {
        "accountId": "string",
        "documentTypeId": "string",
        "documentNumber": 0,
        "documentDueDate": "2021-12-17T13:32:47.849Z",
        "file": {
          "code": "string",
          "name": "string",
          "iso": "string"
        },
        "classifier01": {
          "code": "string",
          "name": "string",
          "iso": "string"
        },
        "classifier02": {
          "code": "string",
          "name": "string",
          "iso": "string"
        },
        "businessCenter": {
          "code": "string",
          "name": "string",
          "iso": "string"
        }
      },
      "providerTypeId": "string",
      "providerTypeAccount": "string",
      "providerTypeAccountDescription": "string"
    },
    "documentTypeId": "string",
    "documentType": {
      "id": "string",
      "siiId": "string",
      "isDigital": true,
      "isBill": true,
      "isTicket": true,
      "modifiesStock": true,
      "isExempt": true,
      "handleUntaxed": true,
      "increaseBook": true,
      "initials": "string",
      "isExportBill": true,
      "isCreditNote": true,
      "isDebitNote": true,
      "isDispatchGuide": true,
      "modifiers": [
        {
          "type": 0,
          "value": 0,
          "class": "string",
          "percentage": 0,
          "name": "string",
          "number": 0,
          "amount": 0
        }
      ],
      "taxes": [
        {
          "type": "string",
          "code": "string",
          "name": "string",
          "id": "string",
          "isEspecific": true,
          "siiCode": "string",
          "taxPercent": 0
        }
      ]
    },
    "documentNumber": 0,
    "address": "string",
    "comment": "string",
    "shopId": "string",
    "shop": {
      "code": "string",
      "name": "string",
      "store": "string",
      "address": "string",
      "businessCode": "string",
      "businessName": "string"
    },
    "documentEmissionDate": "2021-12-17T13:32:47.849Z",
    "accountingDate": "2021-12-17T13:32:47.849Z",
    "amountBeforeTaxes": 0,
    "amountExempt": 0,
    "taxes": [
      {
        "code": "string",
        "name": "string",
        "percent": 0,
        "value": 0,
        "analysis": {
          "accountId": "string",
          "documentTypeId": "string",
          "documentNumber": 0,
          "documentDueDate": "2021-12-17T13:32:47.849Z",
          "file": {
            "code": "string",
            "name": "string",
            "iso": "string"
          },
          "classifier01": {
            "code": "string",
            "name": "string",
            "iso": "string"
          },
          "classifier02": {
            "code": "string",
            "name": "string",
            "iso": "string"
          },
          "businessCenter": {
            "code": "string",
            "name": "string",
            "iso": "string"
          }
        }
      }
    ],
    "amountTotal": 0,
    "documentDueDate": "2021-12-17T13:32:47.849Z",
    "paymentCondition": {
      "code": "string",
      "name": "string",
      "iso": "string"
    },
    "paymentDetail": [
      {
        "line": 0,
        "amount": 0,
        "date": "2021-12-17T13:32:47.850Z"
      }
    ],
    "modifier": 0,
    "nonRecoverableTaxAnalysis": {
      "accountId": "string",
      "documentTypeId": "string",
      "documentNumber": 0,
      "documentDueDate": "2021-12-17T13:32:47.850Z",
      "file": {
        "code": "string",
        "name": "string",
        "iso": "string"
      },
      "classifier01": {
        "code": "string",
        "name": "string",
        "iso": "string"
      },
      "classifier02": {
        "code": "string",
        "name": "string",
        "iso": "string"
      },
      "businessCenter": {
        "code": "string",
        "name": "string",
        "iso": "string"
      }
    },
    "nonRecoverableTaxCode": 0,
    "customFields": [
      {
        "id": 0,
        "name": "string",
        "value": "string",
        "type": 0
      }
    ],
    "purchaseDetails": [
      {
        "line": 0,
        "account": {
          "code": "string",
          "name": "string",
          "iso": "string"
        },
        "expenseAmount": 0,
        "comment": "string",
        "itemId": "string",
        "nameItem": "string",
        "isService": true,
        "quantity": 0,
        "detailAnalysis": {
          "accountId": "string",
          "documentTypeId": "string",
          "documentNumber": 0,
          "documentDueDate": "2021-12-17T13:32:47.850Z",
          "file": {
            "code": "string",
            "name": "string",
            "iso": "string"
          },
          "classifier01": {
            "code": "string",
            "name": "string",
            "iso": "string"
          },
          "classifier02": {
            "code": "string",
            "name": "string",
            "iso": "string"
          },
          "businessCenter": {
            "code": "string",
            "name": "string",
            "iso": "string"
          }
        }
      }
    ],
    "purchaseOrderDetails": [
      {
        "line": 0,
        "quantity": 0,
        "modifiers": 0,
        "modifierType": "string",
        "total": 0,
        "isInventoriable": true,
        "receptionNumber": 0,
        "receptionLine": 0,
        "purchaseOrderSerie": "string",
        "purchaseOrderNumber": 0,
        "purchaseOrderLine": 0,
        "detailType": "string",
        "itemId": "string"
      }
    ],
    "purchaseProductDetails": [
      {
        "line": 0,
        "detailType": "string",
        "itemId": "string",
        "requestedQuantity": 0,
        "measureUnitId": "string",
        "originUnitPrice": 0,
        "unitPrice": 0,
        "modifiers": 0,
        "modifierType": "string",
        "receivedQuantity": 0,
        "returnedQuantity": 0,
        "invoicedQuantity": 0,
        "netAmount": 0,
        "centralizationType": "string",
        "accountId": "string"
      }
    ],
    "relatedDocuments": [
      {
        "line": 0,
        "documentTypeId": "string",
        "documentNumber": 0,
        "totalAmount": 0,
        "documentTypeDescription": "string",
        "documentDate": "2021-12-17T13:32:47.850Z",
        "providerTypeId": "string",
        "relationType": "string"
      }
    ]
  }
}
 GetPurchaseTED

Permite obtener el TED de un documento de compra

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Provider

Código de ID de proveedor

DocumentType

Código del tipo de documento

Number

Numero de documento de compra

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "ted": "string"
}
 GetPDFPurchaseDocumentBase64

Permite obtener el base64 de PDF de un documento de compra

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Provider

Código de ID de proveedor

DocumentType

Código del tipo de documento

Number

Numero de documento de compra

DocumentID

Código de documento de respuesta de SII

Si

ElectronicCode

Codigo para mostrar en el PDF

No

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "base64": "string"
}
 GetXMLPurchaseDocumentBase64

Permite obtener el base64 de XML de un documento de compra

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Provider

Código de ID de proveedor

DocumentType

Código del tipo de documento

Number

Numero de documento de compra

DocumentID

Código de documento de respuesta de SII

Si

ElectronicCode

Codigo para mostrar en el PDF

No

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "base64": "string"
}
 GetSIIStatePurchaseDocument

Permite obtener el estado del SII de un documento de compra

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Provider

Código de ID de proveedor

DocumentType

Código del tipo de documento

Number

Numero de documento de compra

DocumentID

Código de documento de respuesta de SII

Si

ElectronicCode

Codigo para mostrar en el PDF

No

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "state": "string"
}
 ApproveSIIPurchaseDocument

Permite aceptar el contenido de un documento de compra que llega desde el SII

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ProviderID

Código de ID de proveedor

ElectronicCode

Codigo para mostrar en el PDF

No

Number

Numero de documento de compra

Comment

Comentario de documento

No

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 RejectSIIPurchaseDocument

Permite rechazar el contenido de un documento de compra que llega desde el SII

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ProviderID

Código de ID de proveedor

ElectronicCode

Codigo para mostrar en el PDF

No

Number

Numero de documento de compra

Comment

Comentario de documento

No

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 Ley19983PurchaseDocument

Permite obtener datos sobre la Ley19983

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ProviderID

Código de ID de proveedor

ElectronicCode

Codigo para mostrar en el PDF

No

Number

Numero de documento de compra

Type

Tipo de documento

Si

Recinto

Si

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}
 SavePurchase

Permite ingresar documentos de compras asociados ala empresa

Ambientes

Verbo HTTP: POST

Headers

Tipo

Valor

Requerido

Content-Type

“application/json”

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

DocumentTypeId

Se define el codigo del tipo de documento

Si

DocumentEmissionDate

Se define la fecha de emisión del documento

Si

DocumentDueDate

Se define la fecha de vencimiento del documento

Si

ProviderId

Se define el ID del proveedor

Si

ReferencedDocument

Se define el numero de documento a asociar

No

DocumentNumber

Se define el numero del documento (Enviar en 0 para tomar el correlativo)

Si

PaymentConditionId

Se define el codigo de la condicion de pago

Si

Address

Se define la direccion del receptor

Si

ShopId

Se define el código del local de procedencia

Si

ProviderTypeId

Se define el codigo del tipo de proveedor

Si

AmountBeforeTaxes

Se define el valor del total antes del impuesto

Si

AmountExempt

Se define el valor total exento

Si

AmountTotal

Se define el precio total

Si

AccountId (PurchaseDetails)

Se define el código del ID de cuenta contable

Si

ExpenseAmount (PurchaseDetails)

Se define el total de la linea de detalle

Si

IsService (PurchaseDetails)

Se define si es un articulo o servicio

Si

Comment (PurchaseDetails)

Se define un comentario de la linea de detalle

Si

ItemId (PurchaseDetails)

Se define el ID del articulo o servicio

Si

Quantity (PurchaseDetails)

Se define la cantidad de articulos o servicios

Si

FileId (DetailAnalysis)

Se define el ID de ficha

Si

Classifier01 (DetailAnalysis)

Se define el ID de clasificador 1 configurado para el tipo de cuenta contable

Si

Classifier02 (DetailAnalysis)

Se define el ID de clasificador 2 configurado para el tipo de cuenta contable

Si

BusinessCenterId (DetailAnalysis)

Se define el ID de centro de negocio configurado para el tipo de cuenta contable

Si

Code (Taxes)

Se define el código del impuesto

Si

Value (Taxes)

Se define el valor del impuesto

Si

Percentaje (Taxes)

Se define el porcentaje del impuesto

Si

IsIncrease (Taxes)

Si

Modifier

Si

NonRecoverableTaxCode

Se define el iva no recuperable

No

Comment

Se define el comentario del documento

Si

ID (CustomFields)

Se define el ID de un campo personalizable

No

Name (CustomFields)

Se define el Nombre del campo personalizable

No

Value (CustomFields)

Se define el dato del campo personalizable

No

Reason (ReferencedNC)

Se define el código del tipo de nota de crédito

No

Comment (ReferencedNC)

Se define un comentario de la nota de crédito referenciada

No

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "folio": 0
}
 GetAssociatedPurchaseOrder

Permite obtener la orden de compra asociada a un documento de compra

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

"application/json"

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

Provider

Identificador del proveedor

DocumentType

Tipo de documento

Number

Número del documento

Respuesta

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "purchaseOrderNumber": 0
}

SUBSCRIPTION

 Stock

Permite obtener la información de Permite suscribirse a notificaciones de cambio de stock, indicando una URL en la cual recibir un listado de códigos de artículo que han modificado su stock recientemente

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

"application/json"

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

URL

URL de recepción de notificaciones de cambio de stock

Secret

Cadena de validacion a ocupar para validar el JWT recibido en la notificacion

SI

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string"
}

USER

 Get

Permite obtener la información de un usuario

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

"application/json"

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

UserId

ID de Usuario

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "name": "string",
  "phone": "string",
  "email": "string",
  "legalCode": "string",
  "userId": "string",
  "message": "string",
  "exceptionMessage": "string",
  "success": true
}
 List

Permite consultar el listado de usuarios de una empresa

Ambientes

Verbo HTTP: GET

Headers

Tipo

Valor

Requerido

Content-Type

"application/json"

Authorization

Token de autenticación del usuario de Integración. Debe ingresarse con el siguiente formato “bearer TOKEN”

Parámetros

Campo

Descripción

Requerido

ItemsPerPage

Numero de elementos por pagina

Page

Numero de pagina a consultar

Si

Filter

Parámetro opcional para filtrar por nombre, rut, correo e ID de usuario

No

Respuesta

De retorno, en caso de haber ingresado los parámetros de forma correcta, nos retornara una respuesta de la siguiente manera

{
  "success": true,
  "message": "string",
  "exceptionMessage": "string",
  "data": [
    {
      "name": "string",
      "phone": "string",
      "email": "string",
      "legalCode": "string",
      "userId": "string"
    }
  ],
  "totalItems": 0,
  "itemsPerPage": 0,
  "page": 0
}

Artículos Relacionados

  • No labels