A integração disponibilizada para busca de ConEmb trata, em um processo assíncrono, a captura de um documento específico ou uma lista 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 ConEmb que se deseja obter. Este identificador deve ter sido retornado previamente através da consulta da lista de conemb.
Ao receber a lista de identificadores, a aplicação nddFrete localiza em sua base de dados os documentos relacionados à 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>4004</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <EnterpriseId>529ded52-e518-4113-903b-9270b0fba07f</EnterpriseId> <Token>4f8c83c2-2ddd-48d6-b4ea-fb83bae49590</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: o4004 - Busca dos pacotes de ConEmb |
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>prefixo_20170807143042435_29b</Id> <Id>teste_20170807135702086_934</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>4004</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <Guid>811cae53-0aef-4402-be87-4fb7eb70e774</Guid> <EnterpriseId>433a0b6e-3a46-9e1c-b7f8-068e93ebc8c5</EnterpriseId> <Token>6e1b9ce6-8a1c-0c88-3c94-b069a43cabb3</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>4004</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>8</ExchangePattern> <Guid>eb4b981a-1200-4817-a096-fe7c53b0e2e8</Guid> <EnterpriseId>433a0b6e-3a46-9e1c-b7f8-068e93ebc8c5</EnterpriseId> <Token>6e1b9ce6-8a1c-0c88-3c94-b069a43cabb3</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>4004</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <Guid>b69c2ee4-414a-4f50-83ad-d1de911d1010</Guid> <EnterpriseId>0f82b58b-2934-49c0-a73f-e57c4a53e1fd</EnterpriseId> <Token>5257d72b-b60a-4a75-873f-29b626d66906</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_20170809173721805_832</Id><Data>000CHAPECO - EXPRESSO SAO MIGUEL LTDA PROCEDA - CONEMB - V50 1008170921CON501008000 520CONHE501008001 52165849838002577CHAPECO - EXPRESSO SAO MIGUEL LTDA 522CHAPECO - 85 00000000019910112016C65849838002577592757920027990000000000000065056670000175000000000000006353 42161159275792002799570850000001991002767526 000000000 N1IN N 11 5230000000000000000000000000000000000000000000000003150000000000002945000000000000000000000000000000000000000000000000000000000000 000000000000000 N0000000000031500120000000000000037820000000000000000000000000000000000000000000000000000000000000000000000000000000000000 522Penske Log1 00000000000801082017C65849838002577592757920027990000000000000083826973000101000000000000005932 35170865849838002577570010000000081000000082 000000000 N1IN N 11 5230000000000000000000000000000000000000000000000203500 000000000000000000000000000000000000000000000 N0000000002312500120000000000002775020000000000000000000000000000000000000000000000000000000000000000000000000000000000000 5290002000000000020665 </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. |
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 ou o token informado não estão cadastrado no sistema. |
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. |
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. |