Este processo consiste no envio das DOCCOB (fatura) emitida pela transportadora classificados como ETC normal.
Crosstalk de Envio (parâmetro header) |
|---|
Para enviar um documento, além dos dados do mesmo é necessário informar o código da mensagem, bem como, os dados de identificação do cliente conforme layout detalhado abaixo.
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4111</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 da recepção de documentos: O 4111 Envio de DOCCOB (fatura)
|
A01 |
N |
S |
- |
4 |
B02 |
MessageType |
Tipo da operação: 100 |
A01 |
N |
S |
FIXO |
5 |
B03 |
ExchangePattern |
TIpo da mensagem: 7 Envio |
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 |
Documento de envio (Parametro rawdata - exemplo XML DOCCOB) |
00025512677000130 01016473000140 0603181536COB500603000 550COBRA500603001 55101016473000140TRANSPORTADOR01 552NDD 012 00000000010603201807032018000000000045000 I 5550101647300100 00000000045800000000004500028112017 01016473000140 SCPR EMBDEV.28666 35170865849838002577100000000684587000225730 55623700000061926052017 5590001000000000045000 |
Retorno da solicitação |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4111</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 através do Web Service informa se o envio da requisição foi processado 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 |
|---|
Código |
Mensagem |
Situação |
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. |
200 |
A mensagem foi recebida e está sendo processada. |
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. |
999 |
Ocorreu um erro inesperado. |
Erro não catalogado. |
Consulta do Processamento |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4112</ProcessCode> <MessageType>100</MessageType> <ExchangePattern>8</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> </CrosstalkHeader> </CrosstalkMessage> |
A consulta com o ExchangePattern 8 retorna se a solicitação foi processada ou ainda está em processamento.
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 da recepção de documentos: O 4112 Consulta de envio de DOCCOB (fatura) |
A01 |
N |
S |
- |
4 |
B02 |
MessageType |
Tipo da operação: 100 |
A01 |
N |
S |
FIXO |
5 |
B03 |
ExchangePattern |
TIpo da mensagem: 8 |
A01 |
N |
S |
FIXO |
6 |
B04 |
Guid |
Identificador Único da Mensagem |
A01 |
GUID |
S |
Informar Guid do Retorno do processamento |
7 |
B05 |
EnterpriseId |
Identificador para autenticação |
A01 |
GUID |
S |
FIXO |
8 |
B06 |
Token |
Token para autenticação |
A01 |
GUID |
S |
FIXO |
9 |
B07 |
ContentType |
Formato da mensagem enviada: text/xml |
A01 |
C |
S |
FIXO |
Retorno do Processamento |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4112</ProcessCode> <MessageType>100</MessageType> <ExchangePattern>8</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>205</ResponseCode> <ResponseMessage>A mensagem foi processada com sucesso.</ResponseMessage> <CustomId>01234567890</CustomId> </CrosstalkHeader> </CrosstalkMessage> |
Detalhamento do Header:
# |
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 do transportador ou operador logístico informado no envio |
A01 |
GUID |
S |
FIXO |
8 |
B06 |
Token |
Token para autenticação do cliente ou operador logístico informado no envio |
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 |
- |
Detalhamento do Rawdata:
<DataInputResponse Version="1.0"> <InputBlock> <ResponseCode>410</ResponseCode> <ResponseMessage>Processamento realizado com sucesso.</ResponseMessage> </InputBlock> <Document> <Id>EDITAR</Id> <ResponseCode>410</ResponseCode> <ResponseMessage>Processamento realizado com sucesso.</ResponseMessage> </Document> </DataInputResponse> |
# |
ID |
CAMPO |
DESCRIÇÃO |
PAI |
TIPO |
OBR. |
OBS. |
1 |
RAIZ |
DataInputResponse |
Cabeçalho |
- |
- |
S |
FIXO |
2 |
A01 |
InputBlock |
Grupo do Bloco de Retorno |
RAIZ |
- |
S |
FIXO |
3 |
B01 |
ResponseCode |
Código de resposta do processamento |
A01 |
N |
S |
- |
4 |
B02 |
ResponseMessage |
Mensagem referente ao ResponseCode |
A01 |
C |
S |
- |
5 |
A02 |
Document |
Grupo com informações do documento processado |
RAIZ |
C |
S |
- |
6 |
B03 |
Id |
Chave do Documento |
A02 |
N |
S |
- |
7 |
B04 |
ResponseCode |
Código de resposta do processamento |
A02 |
N |
S |
FIXO |
8 |
B05 |
ResponseMessage |
Mensagem referente ao ResponseCode |
A02 |
GUID |
S |
FIXO |
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 do status do documento foi 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 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. |
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. |
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 |
410 |
Processamento realizado com sucesso. |
Cliente e ponto de operação encontrados, documento está bem formado e executou as regras de mapeamento com sucesso. - Documento Disponível |
411 |
Erro ao realizar o processamento. Ocorreu um erro inesperado no processamento do conteúdo. Valor de entrada não condiz com o esperado. |
Documento mal formado ou mapeamento não encontrado. - Documento Não Conforme |
412 |
Processamento realizado com inconsistência. Cliente não informado. Ponto de Operação não está vinculado ao Cliente informado! ou Ponto de Operação não encontrado |
Cliente não encontrado através do CNPJ do emitente. Ou Ponto de operação não encontrado através do DestinationId. - Documento Inconsistente |