Integração para envio de Liberações de Embarque, com o objetivo de vincular os Embarques aos Documentos Fiscais, que podem já ter sido recebidos e estar disponíveis na base de dados ou a ser recebidos posteriormente, disponibilizando para download do Transportador.
A mesma Liberação de Embarque pode ser enviada mais de uma vez, sendo que será mantida sempre a última recebida, descartando todas as anteriores. Desta forma a Embarcadora pode adicionar e remover documentos ao Embarque apenas enviando a lista de documentos atual, bem como remover todos os documentos da Liberação de Embarque, enviando a lista de documentos vazia.
Crosstalk de Envio |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>6000</ProcessCode> <MessageType>100</MessageType> <ExchangePattern>7</ExchangePattern> <EnterpriseId>6c5bac4a-b12f-4c75-87aa-f782a29298dd</EnterpriseId> <Token>98dc2a43-1eed-41a8-869a-e5590f623558</Token> <ContentEncoding>UTF-8</ContentEncoding> <ContentType>txt/xml</ContentType> </CrosstalkHeader> </CrosstalkMessage> |
Detalhamento do Crosstalk |
|---|
# |
ID |
CAMPO |
DESCRIÇÃO |
PAI |
TIPO |
OBR. |
OBS. |
1 |
RAIZ |
CrossTalk_Message |
Tag raiz da mensagem |
- |
- |
S |
FIXO |
2 |
A01 |
CrossTalk_Header |
Cabeçalho |
RAIZ |
- |
S |
FIXO |
3 |
B01 |
ProcessCode |
Código da mensagem de Liberação de Embarque: 6000 |
A01 |
N |
S |
FIXO |
4 |
B02 |
MessageType |
Tipo da operação: 100 |
A01 |
N |
S |
FIXO |
5 |
B03 |
ExchangePattern |
TIpo da mensagem: 7 |
A01 |
N |
S |
FIXO |
6 |
B04 |
EnterpriseId |
Identificador para autenticação |
A01 |
GUID |
S |
FIXO |
7 |
B05 |
Token |
Token para autenticação |
A01 |
GUID |
S |
FIXO |
8 |
B06 |
ContentType |
Formato da mensagem enviada: text/xml |
A01 |
C |
S |
FIXO |
Detalhamento Rawdata |
Os XMLs de documento fiscais (NFe, ProcNFe e procEventoCancNFe) também podem ser enviados na liberação de embarque dentro da tag Document conforme citado abaixo:
<ShipmentRelease_ReceiveFrom_Shipper Version="1.0.0" xsi:noNamespaceSchemaLocation="DocumentEmissionAndDisponibilization_V8.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Release> <Shipment> <DomainName>NDDIGITAL</DomainName> <Xid>01537</Xid> </Shipment> <TaxDocument> <AccessKey>42150206255692000103550020000522421840554936</AccessKey> <OrderRelease> <DomainName>EMBDEV</DomainName> <Xid>ABC123</Xid> </OrderRelease> <Document> <nfeProc versao="3.10" xmlns="" xmlns:ds=""> <NFe xmlns="http://www.portalfiscal.inf.br/nfe"> <infNFe versao="3.10" Id="NFe42150206255692000103550020000522421840554936"> <ide> <cUF>42</cUF> <cNF>84055493</cNF> <natOp>VENDASDE MERC.SUBS.TRIBUTA</natOp> <indPag>1</indPag> <mod>55</mod> <serie>2</serie> <nNF>52242</nNF> <dhEmi>2015-02-11T16:36:10-02:00</dhEmi> <dhSaiEnt>2015-02-11T16:36:10-02:00</dhSaiEnt> <tpNF>1</tpNF> <idDest>1</idDest> <cMunFG>4208906</cMunFG> <tpImp>2</tpImp> <tpEmis>1</tpEmis> <cDV>6</cDV> <tpAmb>1</tpAmb> <finNFe>1</finNFe> <indFinal>0</indFinal> <indPres>1</indPres> <procEmi>0</procEmi> <verProc>4.5.0</verProc> </ide> <emit> <CNPJ>06255692000103</CNPJ> <xNome>NDDigital S/A Software</xNome> <xFant>NDDigital</xFant> <enderEmit> <xLgr>Rua Dr. Walmor Ribeiro</xLgr> <nro>431</nro> <xCpl>NDDigital</xCpl> <xBairro>Coral</xBairro> <cMun>4209300</cMun> <xMun>Lages</xMun> <UF>SC</UF> <CEP>88523060</CEP> <cPais>1058</cPais> <xPais>BRASIL</xPais> <fone>21075500</fone> </enderEmit> <IE>192837645</IE> <CRT>3</CRT> </emit> <dest> <CNPJ>11581859000158</CNPJ> <xNome>N5 Software LTDA</xNome> <enderDest> <xLgr>Rua Dr. Walmor Ribeiro</xLgr> <nro>341</nro> <xBairro>Coral</xBairro> <cMun>4209300</cMun> <xMun>Lages</xMun> <UF>SC</UF> <CEP>88523060</CEP> <cPais>1058</cPais> <xPais>BRASIL</xPais> </enderDest> <indIEDest>1</indIEDest> <IE>192837645</IE> <email>nddigital@nddigital.com.br</email> </dest> <det nItem="1"> <prod> <cProd>11043</cProd> <cEAN/> <xProd>Item 01</xProd> <NCM>83021022</NCM> <CFOP>5405</CFOP> <uCom>PC</uCom> <qCom>1.0000</qCom> <vUnCom>37.3838</vUnCom> <vProd>37.38</vProd> <cEANTrib/> <uTrib>PC</uTrib> <qTrib>1.0000</qTrib> <vUnTrib>37.3838</vUnTrib> <indTot>1</indTot> <xPed>4500155373</xPed> <nItemPed>10</nItemPed> </prod> <imposto> <vTotTrib>6.45</vTotTrib> <ICMS> <ICMS60> <orig>0</orig> <CST>60</CST> <vBCSTRet>29.52</vBCSTRet> <vICMSSTRet>5.02</vICMSSTRet> </ICMS60> </ICMS> </imposto> </det> <total> <ICMSTot> <vBC>0.00</vBC> <vICMS>0.00</vICMS> <vICMSDeson>0.00</vICMSDeson> <vBCST>0.00</vBCST> <vST>0.00</vST> <vProd>37.38</vProd> <vFrete>0.00</vFrete> <vSeg>0.00</vSeg> <vDesc>0.00</vDesc> <vII>0.00</vII> <vIPI>2.99</vIPI> <vPIS>0.62</vPIS> <vCOFINS>2.84</vCOFINS> <vOutro>0.00</vOutro> <vNF>40.37</vNF> <vTotTrib>6.45</vTotTrib> </ICMSTot> </total> <transp> <modFrete>0</modFrete> <transporta> <CNPJ>42158571000107</CNPJ> <xNome>Transportes ABC</xNome> <IE>983214756</IE> <xEnder>Rua Dr. Walmor Ribeiro, 450</xEnder> <xMun>Lages</xMun> <UF>SC</UF> </transporta> </transp> <cobr> <fat> <nFat>252242</nFat> <vOrig>40.37</vOrig> <vLiq>40.37</vLiq> </fat> <dup> <nDup>2522421</nDup> <dVenc>2015-03-18</dVenc> <vDup>40.37</vDup> </dup> </cobr> </infNFe> </NFe> <protNFe versao="3.10"> <infProt> <tpAmb>1</tpAmb> <verAplic>SVRS201501210950</verAplic> <chNFe>42150206255692000103550020000522421840554936</chNFe> <dhRecbto>2015-02-11T16:34:49-02:00</dhRecbto> <nProt>342150016393567</nProt> <digVal>H3pJ8tl7EFIz2np8cRMccv11lV4=</digVal> <cStat>100</cStat> <xMotivo>Autorizado o uso da NF-e</xMotivo> </infProt> </protNFe> </nfeProc> </Document> </TaxDocument> </Release> </ShipmentRelease_ReceiveFrom_Shipper> |
# |
ID |
CAMPO |
DESCRIÇÃO |
PAI |
TIPO |
OBR. |
OBS. |
1 |
RAIZ |
ShipmentRelease_ReceiveFrom_Taker |
Tag raiz da mensagem |
- |
- |
S |
FIXO |
2 |
A01 |
Release |
Campos da Liberação de Embarque |
RAIZ |
- |
S |
FIXO |
3 |
B01 |
Shipment |
Grupo de informações para identificação do Shipment |
A01 |
- |
S |
- |
4 |
C01 |
DomainName |
Domínio de dados do Embarcador no OTM |
B01 |
C |
S |
FIXO |
5 |
C02 |
XId |
Identificador único do Shipment |
B01 |
C |
S |
- |
6 |
B02 |
TaxDocument |
Grupo para informar o documento que será vinculado ao embarque |
A01 |
- |
N |
- |
7 |
C03 |
AccessKey |
Chave do Documento Fiscal |
B02 |
N |
S |
- |
8 |
C04 |
OrderRelease |
Número do Pedido |
B02 |
C |
N |
- |
9 |
C05 |
Document |
XML do Documento NFe |
B02 |
C |
N |
- |
Retorno da solicitação |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>6000</ProcessCode> <MessageType>100</MessageType> <ExchangePattern>7</ExchangePattern> <Guid>97abcd76-f358-4e76-bc0d-8bbb92aef272</Guid> <EnterpriseId>6c5bac4a-b12f-4c75-87aa-f782a29298dd</EnterpriseId> <Token>98dc2a43-1eed-41a8-869a-e5590f623558</Token> <ContentEncoding>UTF-8</ContentEncoding> <ContentType>txt/xml</ContentType> <ResponseCode>200</ResponseCode> <ResponseMessage>A mensagem foi recebida e está sendo processada.</ResponseMessage> <CustomId>01234567890</CustomId> </CrosstalkHeader> </CrosstalkMessage> |
# |
ID |
CAMPO |
DESCRIÇÃO |
PAI |
TIPO |
OBR. |
OBS. |
1 |
RAIZ |
CrossTalk_Message |
Tag raiz da mensagem |
- |
- |
S |
FIXO |
2 |
A01 |
CrossTalk_Header |
Cabeçalho |
RAIZ |
- |
S |
FIXO |
3 |
B01 |
ProcessCode |
Código da mensagem da recepção de documentos informada no envio |
A01 |
N |
S |
- |
4 |
B02 |
MessageType |
Tipo da operação informada no envio |
A01 |
N |
S |
- |
5 |
B03 |
ExchangePattern |
TIpo da mensagem informada no envio |
A01 |
N |
S |
- |
6 |
B04 |
Guid |
Identificador Único da Mensagem |
A01 |
GUID |
S |
- |
7 |
B05 |
EnterpriseId |
Identificador para autenticação |
A01 |
GUID |
S |
FIXO |
8 |
B06 |
Token |
Token para autenticação |
A01 |
GUID |
S |
FIXO |
9 |
B07 |
ContentEnconding |
Codificação da mensagem enviada: UTF-8 |
A01 |
C |
S |
FIXO |
10 |
B08 |
ContentType |
Formato da mensagem enviada: text/xml |
A01 |
C |
S |
FIXO |
11 |
B09 |
ResponseCode |
Código de resposta do processamento |
A01 |
N |
S |
- |
12 |
B10 |
ResponseMessage |
Mensagem referente ao ResponseCode |
A01 |
C |
S |
- |
13 |
B11 |
CustomId |
Identificador da Mensagem |
A01 |
C |
S |
- |
O retorno obtido na primeira requisição do processo assíncrono, informa se a mensagem foi processada com sucesso. Caso a mensagem enviada não possua as tags obrigatórias será retornado falha de schema. Se algum dos campos obrigatórios não estiver no formato correto, a mensagem de retorno criticará o mesmo.
Códigos de Retorno da Solicitação de Processamento |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>6000</ProcessCode> <MessageType>100</MessageType> <ExchangePattern>8</ExchangePattern> <Guid>04c30098-ea34-e811-80f0-00155df90a01</Guid> <EnterpriseId>6c5bac4a-b12f-4c75-87aa-f782a29298dd</EnterpriseId> <Token>18dc2a43-1eed-41a8-869a-e5590f623557</Token> <ContentEncoding>UTF-8</ContentEncoding> <ContentType>txt/xml</ContentType> <ResponseCode>305</ResponseCode> <ResponseMessage>A Liberação de Embarque foi enviada para processamento com sucesso.</ResponseMessage> </CrosstalkHeader> </CrosstalkMessage> |
Código |
Mensagem |
Situação |
200 |
A mensagem foi recebida e está sendo processada. |
Solicitação de envio do documento sendo processada. |
203 |
A mensagem foi rejeitada por causa de falha na validação do esquema do documento. Faça as correções necessárias como erros de esquema e envie a mensagem para processamento |
Estrutura do xml de envio incorreta. |
205 |
A mensagem foi processada com sucesso. |
Solicitação de envio do documento processada com sucesso. |
206 |
A mensagem foi rejeitada porque o cliente não está cadastrado. O cliente não foi encontrado através do EnterpriseId e Token. |
O EnterpriseId e o Token informado não existem na aplicação nddFrete. |
207 |
A mensagem foi rejeitada porque a mensagem já existe na base de dados. |
O GUID da mensagem já existir na aplicação nddFrete. |
210 |
ProcessCode e MessageType inválido |
O ProcessCode ou o MessageType informados não existem na aplicação nddFrete. |
305 |
A liberação de Embarque foi enviada para processamento com sucesso. |
O processo de liberação foi recebido e está sendo realizado. |
999 |
Ocorreu um erro inesperado. |
Erro não catalogado. |