A integração disponibilizada para busca de NOTFIS 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 NOTFIS que se deseja obter. Este identificador deve ter sido retornado previamente através da consulta da lista de NOTFIS.
Ao receber a lista de identificadores, a aplicação nddFrete localiza em sua base de dados os documentos relacionados 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.
Caso ocorra uma atualização no embarque, o documento será disponibilizado para consulta em um novo pacote, sobrescrevendo o anterior. |
Crosstalk de Envio |
|---|
<CrosstalkMessage><CrosstalkHeader> <ProcessCode>4104</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: o4104 - Consulta lista Identificadores NOTFIS |
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 |
EnterpriseId |
Identificador do transportador ou operador logístico. |
A01 |
GUID |
S |
7 |
B05 |
Token |
Token para autenticação do transportador ou operador logístico |
A01 |
GUID |
S |
8 |
B06 |
ContentType |
Formato da mensagem enviada: otext/xml |
A01 |
C |
S |
Solicitação de Pacote |
<DataRequest Version = "1.0"> <Id>notfis_20170810093750788_780</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>4104</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <Guid>da4801e2-2a58-4623-aaae-86e1caf6e962</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>4104</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>8</ExchangePattern> <Guid>5477826a-61fc-4b22-8692-f03c36a71ac1</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>4104</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <Guid>5477826a-61fc-4b22-8692-f03c36a71ac1</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>teste_20170810113644306_a86</Id> <Data> 000CT-E EMITIDO EM AMBIENTE DE HOMOLOGCT-E EMITIDO EM AMBIENTE DE HOMOLOG1008171137NOT501008000 500NOTAS501008001 501Penske Logistic do Brasil LTDA - Cajamar 65849838002577241086922119 000000000000000 Av. Doutor Antonio Joao Abdalla 260 Empresarial Colina Cajamar 07750020 3509205 SP 12072017 1137388565 503CT-E EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALO004855420008780290561299 RODOVIA BR-116 16976 S FAMILIA Caxias do Sul 95054780 4305108 RS 005421015100 1058 1 504CT-E EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALO00485542000878000000290561299RODOVIA BR-116 16976 S FAMILIA Caxias do Sul 4305108 RS 1058 1C 5053 538382 05062017PCS AUTOMOTIVAS 1 C00000000 3517076584983800257757009000022666100022666800022666 000000000000000000000000000000000059275792002799_55_003_000538382_20170605 IOLT.538382_3_12-7-17 5060000120000058720000000000000000000000000000000NN0000000002946590000000002946590000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 515CT-E EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALO59275792002799336985979110 Av. Landri Sales,1070 GUARULHOS 07250130 3518800 SP 08007024200 5190000000002946590000000005872000000000000012000000000001 </Data> </Element> </DataResponse>]]]]>> <![CDATA[ </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. |
A estrutura do xml de envio estiver incorreta. |
205 |
A mensagem foi processada com sucesso. |
O processo de retorno da lista for executado com sucesso. |
216 |
A mensagem foi rejeitada porque o transportador não está cadastrado. O transportador não foi encontrado através do EnterpriseId e Token. |
O enterpriseId informado não está cadastrado no sistema NddFrete. |
218 |
A mensagem foi rejeitada porque o operador não está cadastrado. O operador não foi encontrado através do EnterpriseId e Token. |
O enterpriseId informado não está cadastrado no sistema NddFrete. |
210 |
ProcessCode e MessageType inválido. |
O ProcessCode ou o MessageType informados 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. |
Um erro inesperado, que não foi tratado pelo sistema. |
Códigos 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. |