DOCCOB

Chamada de serviço disponível para recepção de Cobranças para pagamento de documentos fiscais de acordo aos seguintes tipos de arquivos e regras de estruturas/formatação:

Tipo	Modelo	Manual de Formação	Exemplo
Cobrança	Layout DOCCOB	Esquema Cobrança DOCCOB NDD	Arquivo_Cobrança.xml

•Para realizar o upload de COBRANÇAS no formato DOCCOB nddFrete é necessário realizar a parametrização do modelo nas configurações gerais da aplicação fazendo uso do Identificador "MAP_932fd7cc-a868-4124-9410-821c13f05140" para o tipo de documento Fatura de Cobrança.

O recebimento de Cobranças será possível mediante ao uso do código de processo abaixo, através da devida conexão ao serviço nddFrete e uso de credenciais válidas.

Tipo do Documento	ProcessCode
Cobrança	4111

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.

</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

Retorno da solicitação

<ResponseMessage>A mensagem foi recebida e está sendo processada</ResponseMessage>

</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

</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

<ResponseMessage>A mensagem foi processada com sucesso.</ResponseMessage>

</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:

<Description>Fatura de cobrança recepcionada com sucesso</Description>

</Response>

<CarrierName>TRANSPORTADDOR LTDA</CarrierName>

<BranchName>CARROS DO BRASIL AUTOMOVEIS LTDA</BranchName>

</BillingDocument>

<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.