A integração de recepção de fatura de cobrança trata de uma solicitação ao módulo de pagamento para que este realize a conciliação de documentos e retorne a disponibilização do DocCob.
Crosstalk de Envio |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4111</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: o4111 |
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 |
Retorno de Envio |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4011</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> |
Consulta do Processamento |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4111</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>4010</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <Guid>237051b2-5d80-4063-81ba-22f3c0ac0053</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> <RawData><![CDATA[<DocCobEngineResponse Version="1.0.0"><Response><Code>201</Code><Description>A mensagem foi processada com sucesso.</Description></Response></DocCobEngineResponse>]]></RawData> </CrosstalkHeader> <CrosstalkBody> </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 logístico 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. |
Retorno do Rawdata |
|---|
<DocCobEngineResponse Version="1.0.0"> <Response> <Code>100</Code> <Description>Fatura de cobrança recepcionada com sucesso</Description> </Response> <Invoice> <Identification>251</Identification> <CarrierCNPJCPF>39213375000175</CarrierCNPJCPF> <CarrierName>Transportador</CarrierName> <BranchCNPJ>41796776000147</BranchCNPJ> <BillingDocument> <Series>2</Series> <Number>22517</Number> </BillingDocument> <Response> <Code>306</Code> <Description>Os seguintes DPS não foram encontrado na fatura informada: Série: 1, Número: 218. </Description> </Response> <Response> <Code>315</Code> <Description>Os seguintes DPS presentes na fatura não foram encontrados na fatura de cobrança enviada: Série: 12, Número: 2031. </Description> </Response> <Response> <Code>311</Code> <Description>O valor líquido informado no arquivo R$200,00 não é igual ao da fatura R$150,00</Description> </Response> <Response> <Code>313</Code> <Description>A data de vencimento informada no arquivo 01/02/2019 é menor do que a data atual</Description> </Response> <Response> <Code>304</Code> <Description>A data de vencimento informada no arquivo 01/02/2019 não é igual à da fatura 30/05/2019</Description> </Response> </Invoice> </DocCobEngineResponse>
|
Códigos de Erro no 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 |
Os seguintes DPS não foram encontrado na fatura informada: Série: (Série do DPS), Número (Número do DPS). |
Os DPSs informados no arquivo não foram encontrados através da quantidade de DPSs, valor, série ou número. |
307 |
Os seguintes DPS não estão com a situação pagável: Série: (Série do DPS), Número: (Número do DPS). |
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 |
O valor dos seguintes DPS informados no arquivo não coincidem com o valor encontrado no sistema: Série: (Série do DPS), Número: (Número do DPS). Valor DPS Fatura de Cobrança: (Valor DPS Arquivo). Valor DPS Pré-Fatura: (Valor DPS Pré-Fatura). |
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. |
315 |
Os seguintes DPS presentes na fatura não foram encontrados na fatura de cobrança enviada: Série: (Série do DPS), Número: (Número do DPS). |
DPS contendo na pré-fatura não foram encontrados na fatura de cobrança. |
316 |
A regra de pagamento '{Identificador da regra}' está configurada para enviar pré-fatura, porém nenhuma fatura foi encontrada com o identificador: {Identificador da pré-fatura} |
Fatura não encontrada, mas encontrado regra configurada para enviar a pré-fatura. |