A integração disponibilizada para busca de pacote de Fatura trata, em um processo assíncrono, a captura de um documento específico solicitado no momento da requisição ao serviço de integração do nddFrete. Para isso, é necessário informar na chamada de solicitação do documento, o identificador do Pacote de Fatura que se deseja obter. Este identificador deve ter sido retornado previamente através da Consulta Lista de Faturas.
Ao receber a lista de identificadores, a aplicação nddFrete localiza em sua base de dados o documento relacionado a cada pacote, processa-os, monta a mensagem de reposta e marca os documentos como consumidos. Os documentos processados são retornados na busca da resposta da primeira requisição.
Crosstalk de Envio |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4210</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <EnterpriseId>43abeae4-7786-4017-a4ea-a8f54efd0e4a</EnterpriseId> <Token>6901a7fb-f545-c9a1-4ebd-18a723329dfb</Token> <ContentEncoding>UTF-8</ContentEncoding> <ContentType>txt/xml</ContentType> </CrosstalkHeader> </CrosstalkMessage> |
Detalhamento do Crosstalk |
|---|
# |
ID |
Campo |
Descrição |
Pai |
Tipo |
Ob. |
1 |
RAIZ |
CrossTalk_Message |
Tag raiz da mensagem |
- |
- |
S |
2 |
A01 |
CrossTalk_Header |
Cabeçalho |
RAIZ |
- |
S |
3 |
B01 |
ProcessCode |
Código da mensagem marcação de documentos: o4210 - Busca dos pacotes de Fatura |
A01 |
N |
S |
4 |
B02 |
MessageType |
Tipo da operação: o103 |
A01 |
N |
S |
5 |
B03 |
ExchangePattern |
TIpo da mensagem: o7 (assíncrona) o8 (assíncrona) |
A01 |
N |
S |
6 |
B04 |
GUID |
Identificador da mensagem |
A01 |
GUID |
N (Apenas na consulta do processamento) |
7 |
B04 |
EnterpriseId |
Identificador do operador logístico ou do Cliente |
A01 |
GUID |
S |
8 |
B05 |
Token |
Token para autenticação operador logístico |
A01 |
GUID |
S |
9 |
B06 |
ContentType |
Formato da mensagem enviada: otext/xml |
A01 |
C |
S |
Solicitação de Pacote |
<DataRequest Version= "1.0"> <Id>FATURA_65849838002577_59275792002799_4_2</Id> </DataRequest> |
Detalhamento da Consulta |
# |
ID |
Campo |
Descrição |
Pai |
Tipo |
Ob. |
1 |
RAIZ |
DataRequest |
Tag raiz da mensagem |
- |
- |
S |
2 |
A01 |
Id |
Identificador do Pacote |
RAIZ |
- |
S |
Retorno de Envio |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4210</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <Guid>3e58e8ab-b63f-444a-bda1-c390b1b8915b</Guid> <EnterpriseId>43abeae4-7786-4017-a4ea-a8f54efd0e4a</EnterpriseId> <Token>6901a7fb-f545-c9a1-4ebd-18a723329dfb</Token> <ContentEncoding>UTF-8</ContentEncoding> <ContentType>txt/xml</ContentType> <ResponseCode>200</ResponseCode> <ResponseMessage>A mensagem foi recebida e está sendo processada.</ResponseMessage> </CrosstalkHeader> </CrosstalkMessage> |
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. |
Consulta do Processamento |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4210</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>8</ExchangePattern> <Guid>3e58e8ab-b63f-444a-bda1-c390b1b8915b</Guid> <EnterpriseId>43abeae4-7786-4017-a4ea-a8f54efd0e4a</EnterpriseId> <Token>6901a7fb-f545-c9a1-4ebd-18a723329dfb</Token> <ContentEncoding>UTF-8</ContentEncoding> <ContentType>txt/xml</ContentType> </CrosstalkHeader> </CrosstalkMessage> |
A consulta com o ExchangePattern 8 retorna se a solicitação foi processada ou ainda está em processamento.
Retorno do Processamento |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4210</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <Guid>2bafc2c0-b5f5-4189-bb20-6c99f003e7bb</Guid> <EnterpriseId>43abeae4-7786-4017-a4ea-a8f54efd0e4a</EnterpriseId> <Token>6901a7fb-f545-c9a1-4ebd-18a723329dfb</Token> <ContentEncoding>UTF-8</ContentEncoding> <ContentType>txt/xml</ContentType> <ResponseCode>205</ResponseCode> <ResponseMessage>A mensagem foi processada com sucesso.</ResponseMessage> </CrosstalkHeader> <CrosstalkBody> <RawData><![CDATA[<DataResponse Version="1.0"><Element><Id>XML_65849838002577_59275792002799_8_9</Id><Data><infFat><cExtPtoOper>65849838002577</cExtPtoOper><xCnpjOpe>65849838002577</xCnpjOpe><dtEmi>28/09/2017 06:09:44</dtEmi><dVencto>28/09/2017</dVencto><cFat>8</cFat><cExtCli>59275792002799</cExtCli><cLancto>OBRIGATÓRIO E NÃO TEM</cLancto><nContabil>0098</nContabil><vValDesconto>0.00</vValDesconto><NFFat><infNFFat><cCTRC>500025</cCTRC><nCTRC>500025</nCTRC><Serie>9</Serie><vValCTRC>652.00</vValCTRC><xCnpjOpe>OBRIGATÓRIO E NÃO TEM</xCnpjOpe></infNFFat></NFFat></infFat></Data></Element></DataResponse>]]></RawData> </CrosstalkBody> </CrosstalkMessage> |
Códigos Retorno do Cabeçalho da Mensagem |
|---|
Código |
Mensagem |
Situação |
203 |
A mensagem foi rejeitada por causa de falha na validação do esquema do documento |
Estrutura do xml de envio incorreta. |
205 |
A mensagem foi processada com sucesso. |
Processo de retorno da lista executado com sucesso. |
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. |
218 |
A mensagem foi rejeitada porque o operador logistico não está cadastrado. |
O EnterpriseId e o Token informado não existem na aplicação nddFrete. |
220 |
A quantidade de identificadores é maior que o limite de pacotes configurado. |
Número de pacotes solicitados excede ao tamanho configurado para retorno na requisição. |
999 |
Ocorreu um erro inesperado no processamento da mensagem. |
Erro não catalogado |
Códigos de Erro no Retorno do Corpo da Mensagem |
|---|
Código |
Mensagem |
Situação |
404 |
Identificador não encontrado |
Identificador informado na mensagem não existe na base de dados ou, solicitante não possui permissão para consumir o pacote. |
405 |
Erro na execução do mapeamento:{xxx} |
Possíveis erros retornados da transformação do documento. |