NF-e Standard
Based on NDD Frete SOAP Endpoint Architecture, the asynchronous process will be used to send NF-e documents to NDD Frete, so the steps 3 to 6 will be used here:
•Step 3: NF-e sending step. Single or multiple NF-es are allowed.
oSingle NF-e Example:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ndd="http://nddigital.com.br/">
<soapenv:Header/>
<soapenv:Body>
<ndd:Send>
<!--Optional:-->
<ndd:header><![CDATA[
<CrosstalkMessage>
<CrosstalkHeader>
<ProcessCode>6002</ProcessCode>
<MessageType>100</MessageType>
<ExchangePattern>7</ExchangePattern>
<EnterpriseId>e896ef8e-fdad-4fa1-a7a3-3f28666497e7</EnterpriseId>
<Token>05aa89ce-5814-4c29-9584-96887fc09c95</Token>
<ContentEncoding>utf-8</ContentEncoding>
<ContentType>text/xml</ContentType>
</CrosstalkHeader>
</CrosstalkMessage>
]]></ndd:header>
<!--Optional:-->
<ndd:rawdata><![CDATA[
<nfeProc versao="4.00" xmlns="http://www.portalfiscal.inf.br/nfe">
<NFe xmlns="http://www.portalfiscal.inf.br/nfe">
<infNFe versao="4.00" Id="NFe29201044321156000140550010000000011869296432">
<ide>
<cUF>29</cUF>
<cNF>86929643</cNF>
<natOp>VENDA LUBR/COMB AD/REC TERC P/ COMERCIALIZACAO</natOp>
<mod>55</mod>
<serie>1</serie>
<nNF>1</nNF>
<dhEmi>2020-10-31T06:12:19-03:00</dhEmi>
<dhSaiEnt>2020-10-31T06:42:19-03:00</dhSaiEnt>
<tpNF>1</tpNF>
<idDest>1</idDest>
<cMunFG>2914802</cMunFG>
<tpImp>1</tpImp>
<tpEmis>1</tpEmis>
<cDV>2</cDV>
<tpAmb>1</tpAmb>
<finNFe>1</finNFe>
<indFinal>0</indFinal>
<indPres>1</indPres>
<procEmi>0</procEmi>
<verProc>NDDigital NFe 4.8.2</verProc>
</ide>
<emit>
<CNPJ>44321156000140</CNPJ>
<xNome>MATRIZ 12</xNome>
<enderEmit>
<xLgr>ROD BA 415 - KM 36</xLgr>
<nro>S/N</nro>
<xCpl>SALA 15</xCpl>
<xBairro>CENTRO</xBairro>
<cMun>4209300</cMun>
<xMun>LAGES</xMun>
<UF>SC</UF>
<CEP>45600970</CEP>
<cPais>1058</cPais>
<xPais>Brasil</xPais>
<fone>2138912525</fone>
</enderEmit>
<IE>273158593360</IE>
<CRT>3</CRT>
</emit>
<dest>
<CNPJ>52064473000156</CNPJ>
<xNome>FIRMA GRILO</xNome>
<enderDest>
<xLgr>AV JOAO DA SUNGA</xLgr>
<nro>01</nro>
<xCpl>QD H LTS 01 02 03</xCpl>
<xBairro>OLHOS DAGUA</xBairro>
<cMun>4209102</cMun>
<xMun>JOINVILE</xMun>
<UF>SC</UF>
<CEP>45810000</CEP>
<cPais>1058</cPais>
<xPais>Brasil</xPais>
<fone>3998016074</fone>
</enderDest>
<indIEDest>1</indIEDest>
<IE>179832142587</IE>
</dest>
<retirada>
<CNPJ>34516625000122</CNPJ>
<xLgr>ROD BR 415</xLgr>
<nro>SN</nro>
<xCpl>KM 36</xCpl>
<xBairro>DISTRITO INDUSTRIA</xBairro>
<cMun>2914802</cMun>
<xMun>ITABUNA</xMun>
<UF>BA</UF>
</retirada>
<entrega>
<CNPJ>62672651000185</CNPJ>
<xLgr>AV JOAO DA SILVA</xLgr>
<nro>56</nro>
<xCpl>QD H LTS 01 02 03</xCpl>
<xBairro>OLHOS DAGUA</xBairro>
<cMun>2925303</cMun>
<xMun>PORTO SEGURO</xMun>
<UF>BA</UF>
</entrega>
<autXML>
<CNPJ>81512482000160</CNPJ>
</autXML>
<det nItem="1">
<prod>
<cProd>11110000</cProd>
<cEAN>SEM GTIN</cEAN>
<xProd>GASOLINA ORIGINAL C</xProd>
<NCM>27101259</NCM>
<CEST>0600201</CEST>
<cBenef>SEM CBENEF</cBenef>
<CFOP>5655</CFOP>
<uCom>LT</uCom>
<qCom>15000.0000</qCom>
<vUnCom>3.9785000000</vUnCom>
<vProd>59677.50</vProd>
<cEANTrib>SEM GTIN</cEANTrib>
<uTrib>LT</uTrib>
<qTrib>15000.0000</qTrib>
<vUnTrib>3.9785000000</vUnTrib>
<indTot>1</indTot>
<comb>
<cProdANP>320102001</cProdANP>
<descANP>Gasolina C Comum</descANP>
<UFCons>BA</UFCons>
</comb>
</prod>
<imposto>
<ICMS>
<ICMSST>
<orig>0</orig>
<CST>60</CST>
<vBCSTRet>66030.00</vBCSTRet>
<vICMSSTRet>18488.40</vICMSSTRet>
<vBCSTDest>0.00</vBCSTDest>
<vICMSSTDest>0.00</vICMSSTDest>
</ICMSST>
</ICMS>
<IPI>
<cEnq>999</cEnq>
<IPINT>
<CST>53</CST>
</IPINT>
</IPI>
<PIS>
<PISNT>
<CST>04</CST>
</PISNT>
</PIS>
<COFINS>
<COFINSNT>
<CST>04</CST>
</COFINSNT>
</COFINS>
</imposto>
<infAdProd>ONU3475 MISTURA DE ETANOL E GASOLINA, Classe Risco: 3, GE: II.</infAdProd>
</det>
<total>
<ICMSTot>
<vBC>0.00</vBC>
<vICMS>0.00</vICMS>
<vICMSDeson>0.00</vICMSDeson>
<vFCPUFDest>0.00</vFCPUFDest>
<vICMSUFDest>0.00</vICMSUFDest>
<vICMSUFRemet>0.00</vICMSUFRemet>
<vFCP>0.00</vFCP>
<vBCST>0.00</vBCST>
<vST>0.00</vST>
<vFCPST>0.00</vFCPST>
<vFCPSTRet>0.00</vFCPSTRet>
<vProd>59677.50</vProd>
<vFrete>0.00</vFrete>
<vSeg>0.00</vSeg>
<vDesc>0.00</vDesc>
<vII>0.00</vII>
<vIPI>0.00</vIPI>
<vIPIDevol>0.00</vIPIDevol>
<vPIS>0.00</vPIS>
<vCOFINS>0.00</vCOFINS>
<vOutro>0.00</vOutro>
<vNF>59677.50</vNF>
<vTotTrib>0.00</vTotTrib>
</ICMSTot>
</total>
<transp>
<modFrete>1</modFrete>
<transporta>
<CNPJ>68888328000120</CNPJ>
<xNome>AUTO POSTO 3</xNome>
<IE>81322167</IE>
<xEnder>CARLOS RAMOS</xEnder>
<xMun>EUNAPOLIS</xMun>
<UF>BA</UF>
</transporta>
<veicTransp>
<placa>ABC3215</placa>
<UF>BA</UF>
</veicTransp>
<vol>
<qVol>15000</qVol>
<esp>COMBUSTIVEL GRANEL</esp>
<marca>NOVAMARCA</marca>
<pesoL>11053.500</pesoL>
<pesoB>11053.500</pesoB>
<lacres>
<nLacre>144304</nLacre>
</lacres>
<lacres>
<nLacre>144303</nLacre>
</lacres>
<lacres>
<nLacre>144302</nLacre>
</lacres>
<lacres>
<nLacre>144301</nLacre>
</lacres>
<lacres>
<nLacre>144300</nLacre>
</lacres>
<lacres>
<nLacre>144299</nLacre>
</lacres>
</vol>
</transp>
<cobr>
<fat>
<nFat>53933</nFat>
<vOrig>59677.50</vOrig>
<vDesc>0.00</vDesc>
<vLiq>59677.50</vLiq>
</fat>
</cobr>
<pag>
<detPag>
<tPag>01</tPag>
<vPag>59677.50</vPag>
</detPag>
</pag>
<infAdic>
<obsCont xCampo="CodigoPontoDeEntrega">
<xTexto>01</xTexto>
</obsCont>
<obsCont xCampo="infoVeicTransp">
<xTexto>BANYZ5255-1</xTexto>
</obsCont>
</infAdic>
</infNFe>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
<Reference URI="#NFe29201033337122022600550030000539331869296432">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/>
<Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
<DigestValue>+sX2vqO/dkSDsbtYwP8E65weCQg=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>YwuJKKXlGiHxen5NiaQvfmLOCd2rlhWTz6rdKTIpmmeI9bnSXQsXBqWOHtdO65VE4uDCAdMhHwMphbhp05atujG5mbI/ld7StDEBxbuBD01h1XGsUPDIGiWAc8W5K8tYBE6nW0AmtUDWUy/u5MRnGsFdftaSD+wmJSiKMiWGztX+bajkwRiQmEgJVec7vpxpseyDxcIdNz+cLW/tvsGhsv6L9YMY5UEwRVLmvw3dmBHW/KSgz3YyTVANK9+NBlg7WRf33UFQ4x+VmkciYVQwGp0+0cgwWSJvS8Q2VIGiaac1RPxKEh/7if4HHT1VnUMjQeDFjyhbRxe78ZLkX6BE6g==</SignatureValue>
<KeyInfo>
<X509Data>
<X509Certificate>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</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>
</NFe>
<protNFe versao="4.00">
<infProt Id="NFe129201318256562">
<tpAmb>1</tpAmb>
<verAplic>6.0</verAplic>
<chNFe>29201044321156000140550030000539331869296432</chNFe>
<dhRecbto>2020-10-31T06:12:23-03:00</dhRecbto>
<nProt>129201318256562</nProt>
<digVal>+sX2vqO/dkSDsbtYwP8E65weCQg=</digVal>
<cStat>100</cStat>
<xMotivo>Autorizado o uso da NF-e</xMotivo>
</infProt>
</protNFe>
</nfeProc>
]]></ndd:rawdata>
</ndd:Send>
</soapenv:Body>
</soapenv:Envelope>
oMultiple NF-es:
oOnly with CompressedSend Method.
•Step 4: Sending result. This step is a result from the previous request, it will return if NDD Frete was able to receive the external call or not. The result is based on Request Settings Structure (header), and the ResponseCode will inform if the message has been received.
oExample:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<SendResponse xmlns="http://nddigital.com.br/">
<SendResult><![CDATA[
<CrosstalkMessage>
<CrosstalkHeader>
<ProcessCode>6002</ProcessCode>
<MessageType>100</MessageType>
<ExchangePattern>7</ExchangePattern>
<Guid>5713de42-100f-ec11-9ae5-000d3ac10626</Guid>
<EnterpriseId>3296265a-1861-4170-8c7e-89de8b10162d</EnterpriseId>
<Token>1ac9cc6b-5044-4abf-a418-a6a42527628e</Token>
<ContentEncoding>utf-8</ContentEncoding>
<ContentType>text/xml</ContentType>
<ResponseCode>200</ResponseCode>
<ResponseMessage>A mensagem foi recebida e está sendo processada.</ResponseMessage>
</CrosstalkHeader>
</CrosstalkMessage>
]]></SendResult>
</SendResponse>
</soap:Body>
</soap:Envelope>
•Step 5: This request is not mandatory and is used to check if the NF-es sent were successful processed. In order to get the NF-es processing result, the external system must inform the <Guid> returned at step 4 response and set "8" in the <ExchangePattern> parameter, just like the following image:
PS.: The <Guid> retrived at step 4 will be an input in this step.
oExample
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ndd="http://nddigital.com.br/">
<soapenv:Header/>
<soapenv:Body>
<ndd:Send>
<!--Optional:-->
<ndd:header><![CDATA[
<CrosstalkMessage>
<CrosstalkHeader>
<ProcessCode>6002</ProcessCode>
<MessageType>100</MessageType>
<ExchangePattern>8</ExchangePattern>
<Guid>5713de42-100f-ec11-9ae5-000d3ac10626</Guid>
<EnterpriseId>3296265a-1861-4170-8c7e-89de8b10162d</EnterpriseId>
<Token>1ac9cc6b-5044-4abf-a418-a6a42527628e</Token>
<ContentEncoding>utf-8</ContentEncoding>
<ContentType>text/xml</ContentType>
</CrosstalkHeader>
</CrosstalkMessage>
]]></ndd:header>
<!--Optional:-->
<ndd:rawdata></ndd:rawdata>
</ndd:Send>
</soapenv:Body>
</soapenv:Envelope>
•Step 6: The NF-es processing result will be informed in the Dynamic Content (rawdata), at the following structure:
oExample:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<SendResponse xmlns="http://nddigital.com.br/">
<SendResult><![CDATA[
<CrosstalkMessage>
<CrosstalkHeader>
<ProcessCode>6002</ProcessCode>
<MessageType>100</MessageType>
<ExchangePattern>8</ExchangePattern>
<Guid>5713de42-100f-ec11-9ae5-000d3ac10626</Guid>
<EnterpriseId>3296265a-1861-4170-8c7e-89de8b10162d</EnterpriseId>
<Token>1ac9cc6b-5044-4abf-a418-a6a42527628e</Token>
<ContentEncoding>utf-8</ContentEncoding>
<ContentType>text/xml</ContentType>
<ResponseCode>205</ResponseCode>
<ResponseMessage>A mensagem foi processada com sucesso.</ResponseMessage>
</CrosstalkHeader>
<CrosstalkBody>
<RawData>
<![CDATA[
<DataInputResponse Version="1.0">
<InputBlock>
<ResponseCode>410</ResponseCode>
<ResponseMessage>Processamento realizado com sucesso.</ResponseMessage>
</InputBlock>
<Document>
<Id>29201033337122022600550010000000011869296432</Id>
<ResponseCode>422</ResponseCode>
<ResponseMessage>Processamento realizado com inconsistência. O Documento Originário não possui nenhuma relação informada de vínculo com Ordens/Embarques!</ResponseMessage>
</Document>
</DataInputResponse>]]]]>>
<![CDATA[
</RawData>
</CrosstalkBody>
</CrosstalkMessage>
]]></SendResult>
</SendResponse>
</soap:Body>
</soap:Envelope>
oResponseCode: The processing result code, check each code meaning bellow:
Code |
Message |
Situation |
409 |
Em processamento. Processing. |
|
410 |
Processamento realizado com sucesso. Document successful processed. |
|
411 |
Erro ao realizar o processamento. Ocorreu um erro inesperado no processamento do conteúdo, valor de entrada não condiz com o esperado. The content informed in step 3 didn't meet what NDD Frete was expecting (NF-e). |
|
412 |
Processamento realizado com inconsistência. |
|
413 |
Processamento realizado com inconsistência. NF-e {Chave NF-e} não encontrada. |
|
414 |
Processamento realizado com inconsistência. Não é possível receber cancelamento de NF-e vinculada a embarque liberado |
|
415 |
Liberação de Embarque não pode ser enviada para processamento. Não é possível receber a Liberação de Embarque porque o Embarque já está liberado. |
|
416 |
A Liberação de Embarque foi enviada para processamento com sucesso. |
|
417 |
O emitente/destinatário da NF-e não é uma filial cadastrada. |
|
418 |
Ordem(ns) não encontrada(s): {Lista de ordens} |
|
419 |
Liberação de embarque já encontrada para a {Chave NF-e} |
|
420 |
Falha na Integração TMS. |
|
421 |
Não foi encontrado a(s) Ordem(ns) com o número do pedido informado no Documento Originário: {Chave NF-e} |
|
422 |
O Documento Originário não possui nenhuma relação informada de vínculo com Ordens/Embarques! |
|
423 |
Ocorreu um erro na integração das informações do Documento Originário. |
|
424 |
Documentos cancelados não podem ser vinculados a embarques. |
|
425 |
O Documento Originário não possui vinculo com Ordens/Embarques. |