Webservice documentation for Ready Delivery integration

Disponível em:

Este artigo documenta as configurações de integração necessárias entre o ERP e o Módulo de Pronta Entrega do Demander.

🔹 Requisitos de Integração

Para a integração com o Módulo de Pronta Entrega, o ERP deve disponibilizar um endpoint (Webservice) que será acionado pelo Demander.

⚠️ Este endpoint será configurado individualmente para cada empresa.

🔹 Método POST

O ERP deve fornecer um endpoint que aceite requisições HTTP POST.

O Demander enviará no Body um JSON, no seguinte formato:

{

“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||”

]

}

• Esse JSON corresponde ao mesmo layout do arquivo texto já enviado ao ERP pela integração tradicional.
• Usando a aplicação https://jsonformatter.curiousconcept.com/ podemos ver melhor o que é enviado ao ERP. Neste exemplo não tem o registro de cliente, mas ele pode estar junto, pois pode ser um cliente novo.
• O ERP deve converter o JSON em arquivo texto e processar normalmente, para evitar duplicidade de lógicas de importação.

📌 Importante: O webservice deve estar preparado para receber requisições repetidas. Caso o mesmo pedido seja reenviado, o ERP não deve gerar uma nova NF, mas sim retornar o mesmo JSON de resposta.

🔹 Autenticação

A autenticação é opcional.

• Pode ser usada, por exemplo, em ERPs online, para diferenciar empresas.

Quando utilizada, deve ser no formato Basic Auth.

🔹 Retorno esperado pelo Demander

O ERP deve responder com um JSON no Body da Response.

Estrutura esperada:

• retorno
  • Se o valor for NFOK, o Demander entende que o processo foi concluído com sucesso e prossegue com a impressão da NF-e, Boleto e Documento Auxiliar.
  • Qualquer outro valor será exibido como mensagem de erro no Demander Android.
• xmlboleto (opcional)
  • Deve conter o XML dos boletos gerados.
  • Caso não seja enviado, o Demander não imprimirá boletos.

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)
  • Deve conter o XML da NF-e gerada.
  • Caso não seja enviado, o Demander não imprimirá a Danfe.
• documento_auxiliar (opcional)
  • XML com informações para impressão de um documento auxiliar.
  • Cada tag será impressa como uma linha no 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

• Código do cliente gerado no ERP.