Envio Fatura de Cobrança (Doccob)

Anterior
Próximo
Imprimir

Envio Fatura de Cobrança (Doccob)

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.