Ir al contenido
DemanderDemanderDemander Docs
Claro
Español

Documentación del servicio web para la integración de Ready Delivery

Disponível em:

Captura da tela 1

Este artículo documenta las configuraciones de integración necesarias entre el ERP y el Módulo de Entrega Inmediata de Demander.

🔹 Requisitos de Integración

Sección titulada «🔹 Requisitos de Integración»

Para la integración con el Módulo de Entrega Inmediata, el ERP debe disponibilizar un endpoint (servicio web) que será llamado por Demander.

⚠️ Este endpoint se configurará individualmente para cada empresa.

🔹 Método POST

Sección titulada «🔹 Método POST»

El ERP debe proporcionar un endpoint que acepte solicitudes HTTP POST.

Demander enviará en el Body un JSON con el siguiente formato:

Captura da tela 2

{
  "arquivo": [
    "16|4556984|405731|1|1|||43|95.207.429/0001-60|1|5000122||405731|||2019-03-26 13:47:06|4.10|0.00|1|||||||1||5000122|||4|0.00|4.10|0|0.00|0.00|0||R$|0.00|0.00|0.00||0.00||||||0||0.00|0.00|||3268530|0|0|0||||",
    "17|73821209|59439|405731|0|0|4.10|4.1|4.1|1|4556984||0.00|0.00|4.10|4.1|0.00|4.10|4.1|0.00|0.00|0.00|4.1|0||0.00000|0.00|||0|4.1|0.00|0.00|0|0|0|0.00||"
  ]
}
  • Este JSON corresponde al mismo diseño del archivo de texto enviado al ERP en la integración tradicional.
  • Usando aplicaciones como https://jsonformatter.curiousconcept.com/ se puede visualizar mejor lo que se envía al ERP. En este ejemplo no aparece el registro de cliente, pero puede incluirse si es un cliente nuevo.
  • El ERP debe convertir el JSON a un archivo de texto y procesarlo normalmente, evitando duplicar lógicas de importación.

📌 Importante: El servicio web debe estar preparado para recibir solicitudes repetidas. Si se reenvía el mismo pedido, el ERP no debe generar una nueva factura, sino devolver el mismo JSON de respuesta.

🔹 Autenticación

Sección titulada «🔹 Autenticación»

La autenticación es opcional.

  • Se puede utilizar, por ejemplo, en ERPs en la nube para distinguir empresas.

Cuando se utilice, debe ser en formato Basic Auth.

🔹 Retorno esperado por Demander

Sección titulada «🔹 Retorno esperado por Demander»

El ERP debe responder con un JSON en el cuerpo de la respuesta.

Captura da tela 3

Captura da tela 4

Estructura esperada:

Sección titulada «Estructura esperada:»
  • retorno
    • Si el valor es NFOK, Demander entiende que el proceso se completó con éxito y continúa con la impresión de la factura, boleta y documento auxiliar.
    • Cualquier otro valor se mostrará como mensaje de error en Demander Android.
  • xmlboleto (opcional)
    • Debe contener el XML de las boletas generadas.
    • Si no se envía, Demander no imprimirá boletas.
xml version="1.0" encoding="UTF-8"?>


 748-X


 74891.11729 00016.401564 03340.091085 4 70840000056261


 PAGAVEL PREFERENCIALMENTE NAS COOPERATIVAS DE CREDITO SICREDI


 28/02/2017


 RETTA TECNOLOGIA DA INFORMAÇÃO LTDA


 07.676.543/0001-72


 RUA AVELINO TALLINI, 171 LAJEADO-RS


 01179.03.91561


 07/02/2017


 001000388490101


 A


 R$ 562,61


 01.00038849.001


 N


 07/02/2017


 17/200016-4


 CR


 R$


 Instru\u00E7\u00F5es (Texto de responsabilidade do benefici\u00E1rio)


 DOCUMENTO: 001.090.15.001PROTESTAR AUTOMATICAMENTE 3 DIAS AP\u00D3S O VENCIMENTOPROTESTAR 3 DIAS APOS O VENCIMENTO.JUROS DE 0,12% AO DIA.


 DIEGO TIEMANN


 0LAJEADO / RS 96020-000


 012.121.323-34


 008754-8


 (-) Desconto / Abatimento


 (-) Outras dedu\u00E7\u00F5es


 Esp\u00E9cie


 Quantidade


 S\u00E9rie: NFe AM


 74894708400000562611117200016401560334009108


 s1d8qw94d13as1d9w1f316a
  • xmlnfe (opcional)
    • Debe contener el XML de la factura generada.
    • Si no se envía, Demander no imprimirá Danfe.
  • documento_auxiliar (opcional)
    • XML con datos para la impresión de un documento auxiliar.
    • Cada etiqueta se imprimirá como una línea en el documento.
xml version="1.0" encoding="UTF-8"?>


 NF: 000795


 Data emiss\u00E3o: 07/03/2017


 Cliente: DIEGO TIEMANN


 Cod item Descri\u00E7\u00E3o Quantidade Vl. l\u00EDq unit


 -------------------------------------------------------------------------------------


 000038-8 ERVA MATE TR.LAM.6X1KG* 6,00 8,00


 000089-2 ERVA MATE M.GRO.LAM.6X1KG* 6,00 8,00


 002770-7 ERVA MATE PREMIUM VACUO 10X1 10,00 8,00


 002774-0 ERVA MATE COMPOSTO 12x500GR* 6,00 5,20


 003390-1 ERVA MATE TRAD 6X1KG* 156,00 6,00


 402403-6 ERVA MATE M.G 12X500GR LAM 20,00 4,10


 Valor total dos produtos: 1.225,20


 N do pedido: 00500006


 Opera\u00E7\u00E3o: VENDA A VISTA


 Forma pagamento da conta: CHEQUE-PR\u00C9


 Vencimentos: 08/03/2017 1.225,20


 ____________________________________

codclientezada

Sección titulada «codclientezada»
  • Código del cliente generado en el ERP.

Artículos relacionados