Este processo consiste no envio das faturas de cobrança (conforme o layout definido) emitida pela transportadora classificados como ETC normal. Para que efetue a conciliação com a Pré Fatura de pagamento.
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 (Parâmetro rawdata) |
•Exemplo XML DOCCOB - Padrão NDD
00025512677000130 01016473000140 0603181536COB500603000 550COBRA500603001 55101016473000140TRANSPORTADOR01 552NDD 012 00000000010603201807032018000000000045000 I 5550101647300100 00000000045800000000004500028112017 01016473000140 SCPR EMBDEV.28666 35170865849838002577100000000684587000225730 55623700000061926052017 5590001000000000045000 |
•Exemplo XML CONEMB - Padrão NDD
000TRANSPORTADDOR LTDA 52548435015524 29052018112502CON290511252 320CONHE29051129123 321TRANSPORTADDOR LTDA 52548435015524 135271 CARROS DO BRASIL AUTOMOVEIS LTDA 04104117000761 3789 32252548435015524 79218954 033180252548435015524570030000212351050102678 22022018C000000000005247 000000000001696 00000000000789000000000000789001200 2 0000000000009471 25480 1 25481 UNBR08 000000005690960 000000000860000DIVERSOS 000000004691120SANTO ANDRE 3547809SPRESENDE 3304201RJ1 1234 1806201812345 QCN1 CC1 32252548435015524 79218954 033180252548435015524570030000212361050102683 22022018C000000000007739 000000000002502 00000000001163800000000001163801200 2 0000000000013971 120236 1 120237 1 120238 1 120239 1 120240 1 120241 1 120242 1 120329 1 120330 1 120331 1 120332 1 120333 1 120334 1 120335 1 120336 1 120337 1 120338 1 120339 UNBR08 000000008394320 000000000830000DIVERSOS 000000006838698SAO BERNARDO DO CAMPO 3548708SPRESENDE 3304201RJ1 1234 1806201812345 QCN1 CC2 32252548435015524 79218954 033180252548435015524570030000212371050102699 22022018C000000000053136 000000000017177 00000000000789000000000007990101200 2 0000000000095880 139796 0 139797 0 139798 0 139799 0 139800 0 139801 0 139802 0 139803 0 139804 0 139805 0 139806 UNBR08 000000057633830 000000001480000DIVERSOS 000000013096768SAO BERNARDO DO CAMPO 3548708SPRESENDE 3304201RJ1 1234 1806201812345 QCN2 CC1 3230003000000000099429 |
Documento |
Tipo |
Manual de formação |
Fatura |
Layout DOCCOB NDD |
|
Fatura |
Layout CONEMB NDD |
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>4111</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>4111</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:
<DocCobEngineResponse Version="1.0.0"> <Response> <Code>100</Code> <Description>Fatura de cobrança recepcionada com sucesso</Description> </Response> <Invoice> <Identification>5454</Identification> <CarrierCNPJCPF>39831471000187</CarrierCNPJCPF> <CarrierName>TRANSPORTADDOR LTDA</CarrierName> <BranchCNPJ>62864217000105</BranchCNPJ> <BranchName>CARROS DO BRASIL AUTOMOVEIS LTDA</BranchName> <BranchStateRegistration>546546</BranchStateRegistration> <BillingDocument> <Series>1</Series> <Number>123456789</Number> </BillingDocument> <Response> <Code>101</Code> <Description>Fatura de cobrança conciliada com sucesso</Description> </Response> </Invoice> </DocCobEngineResponse>
|
# |
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 |
100 |
Fatura de cobrança recepcionada com sucesso. |
Fatura foi recepcionada e processada. |
101 |
Fatura de cobrança conciliada com sucesso. |
Fatura foi validada e conciliada com sucesso. |
102 |
Fatura de cobrança já foi recepcionada. |
Fatura de cobrança já foi recepcionada e será descartada. |
200 |
Identificador do mapeamento não encontrado. |
Identificador não cadastrado ou incorreto. |
201 |
Falha na execução do mapeador. |
Documento não atende as regras de mapeamento. |
300 |
A fatura está fechada ou cancelada. |
Fatura fechadas ou canceladas não podem ser conciliadas. |
301 |
A fatura não possui regra vinculada e não está marcada para recepcionar fatura de cobrança. |
Não possui regra vinculada e não está marcada para recepcionar fatura de cobrança. |
302 |
Regra de pagamento não encontrada. |
Não existe regra para a filial e transportador informado. |
303 |
A regra de pagamento (Identificador) não está configurado para recepcionar fatura de cobrança. |
Regra de pagamento encontrada não recepciona fatura de cobrança. |
304 |
A data de vencimento informada no arquivo (data do arquivo) não é igual à da fatura (data da fatura). |
A data de vencimento não foi encontrada através do dia, mês e ano, ou o valor líquido da fatura não confere com o valor líquido informado no arquivo. |
305 |
O CNPJ/CPF do transportador informado no arquivo (CNPJ/CPF do arquivo) não é igual ao da fatura (CNPJ/CPF da fatura). |
O CNPJ/CPF do transportador ou tomador não são iguais ao da fatura. |
306 |
Um ou mais DPSs informados no arquivo não são iguais ao da fatura. |
Os DPSs informados no arquivo não foram encontrados através da quantidade de DPSs, valor, série ou número. |
307 |
Um ou mais DPSs informados no arquivo não foram encontrados com a situação pagável na base de dados. |
Os DPSs informados não foram encontrados através da série, número e CNPJ/CPF do transportador e/ou não se encontram com status de Pagáveis. |
308 |
Um ou mais DPSs informados no arquivo não possuem o mesmo valor dos DPSs da base de dados. |
Um ou mais DPSs informados nao possuem o mesmo valor dos DPSs da base de dados. |
309 |
O valor líquido da fatura informado no arquivo (R$ valor) não é o mesmo do valor total dos DPSs (R$ valor). |
A soma do total dos valores dos dps não se equivale ao valor liquido da fatura. |
310 |
Transportador não encontrado. |
CNPJ/CPF do transportador informado no arquivo não foi encontrado na base de dados. |
311 |
O valor líquido informado no arquivo (R$ valor) não é igual ao da fatura (R$ valor). |
Valor informado no arquivo não é igual ao da Fatura encontrada na base de dados do nddFrete. |
312 |
O CNPJ/CPF da filial/ponto de operação informado no arquivo (CNPJCPF) não é igual ao da fatura (CNPJCPF). |
Valor informado no arquivo não é igual ao da Fatura encontrada na base de dados do nddFrete. |
313 |
A data de vencimento informada no arquivo (data) é menor do que a data atual. |
A data de vencimento informada na fatura de cobrança é menor que a data atual. |
314 |
Já existe fatura de cobrança validada vinculada à pré-fatura 91. |
A pré-fatura informada já possuí uma fatura de cobrança valida a vinculada a ela. |