Skip to content
DemanderDemanderDemander Docs
Light
English

Webservice documentation for Ready Delivery integration

Available on:

Captura da tela 1

This article documents the integration settings required between the ERP and the Ready Delivery Module of Demander.

🔹 Integration Requirements

Section titled “🔹 Integration Requirements”

To integrate with the Ready Delivery Module, the ERP must provide an endpoint (Webservice) that will be triggered by Demander.

⚠️ This endpoint will be configured individually for each company.

🔹 POST Method

Section titled “🔹 POST Method”

The ERP must provide an endpoint that accepts HTTP POST requests.

Demander will send a JSON in the Body, in the following format:

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||"
  ]
}
  • This JSON corresponds to the same layout as the text file already sent to the ERP via traditional integration.
  • Using tools such as https://jsonformatter.curiousconcept.com/ makes it easier to inspect what is sent to the ERP. In this example there is no customer record, but it can be included if it is a new customer.
  • The ERP should convert the JSON into a text file and process it normally, preventing duplicate import logic.

📌 Important: The webservice must be prepared to receive repeated requests. If the same order is resent, the ERP must not issue a new invoice, but instead return the same response JSON.

🔹 Authentication

Section titled “🔹 Authentication”

Authentication is optional.

  • It can be used, for example, in cloud ERPs to differentiate companies.

When used, it must follow the Basic Auth format.

🔹 Expected Return by Demander

Section titled “🔹 Expected Return by Demander”

The ERP must respond with a JSON payload in the Response Body.

Captura da tela 3

Captura da tela 4

Expected Structure:

Section titled “Expected Structure:”
  • retorno
    • If the value is NFOK, Demander considers the process successfully completed and proceeds with printing the invoice, bank slip, and auxiliary document.
    • Any other value will be displayed as an error message in Demander Android.
  • xmlboleto (optional)
    • Must contain the XML of the generated bank slips.
    • If not provided, Demander will not print bank slips.
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 (optional)
    • Must contain the XML of the generated NF-e.
    • If not provided, Demander will not print Danfe.
  • documento_auxiliar (optional)
    • XML containing information to print an auxiliary document.
    • Each tag will be printed as a line on the document.
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

Section titled “codclientezada”
  • Customer code generated in the ERP.

Related articles