O nddFrete > Serviço > Gestão Fiscal > Documentos do Transporte

Tipo	Modelo	Manual de Formação	Exemplo
NFS-e	Layout NFSe NDD	Esquema NFS-e NDD	Arquivo NFSe.xml

O recebimento do documento do transporte do tipo NFS-e NDD ou de seus eventos relacionados, 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
NFS-e	2300

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 transportador ou do Embarcador 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: o2300 Envio de XML de NFS-e NDD (Autorização ou Cancelamento)	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	CustomId	Identificador customizado	A01		-	-
9	B07	ContentType	Formato da mensagem enviada: text/xml	A01	C	S	FIXO

Documento de envio (parâmetro rawdata)

</IdentificacaoRps>

</DadosComplementaresServico>

</Servico>

</Valores>

</AliquotasComplementares>

<Discriminacao>Operação de transporte intramunicipal</Discriminacao>

<MunicipioPrestacaoDescricao>Lages</MunicipioPrestacaoDescricao>

<Item>

<DiscriminacaoServico>Teste Lista de serviço NDDigital !@#$%¨&*()_+</DiscriminacaoServico>

</Item>

</ListaItens>

</DadosComplementaresServico>

</Servicos>

</Prestador>

<RazaoSocial>Tomador</RazaoSocial>

</IdentificacaoTomador>

<Endereco>R. Dr. Valmor Ribeiro</Endereco>

<Bairro>Coral</Bairro>

</EnderecoTomador>

</Tomador>

</InfRps>

<CodigoVerificacao>XMORNPWLY</CodigoVerificacao>

</ValoresServico>

</InfNfse>

<Email>

<ReceiverTo>markizene.lima@ndd.com.br</ReceiverTo>

</ReceiverToList>

<Subject>testes</Subject>

</Email>

</DadosAdic>

<Formulario>boleto</Formulario>

<NomeCampo>NAMEBOLETO.0</NomeCampo>

</CodigoBarra>

<NomeCampo>NAMEBOLETOFORMATADO.0</NomeCampo>

</CodigoBarra>

</ListaCodigoBarra>

<ValorCampo>boleto</ValorCampo>

</CampoAdicionalBoleto>

</CamposAdicionaisBoleto>

<NomeCampo>boleto</NomeCampo>

</DadoAdicionalPrimeiroBoleto>

</Boleto>

</Boletos>

</Rps>

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	-

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.
216	A mensagem foi rejeitada porque o transportador não está cadastrado. O transportador 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: o2300	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 anterior	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 informado no envio	A01	GUID	S	FIXO
8	B06	Token	Token para autenticação do transportador 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:

<ResponseMessage>Processamento realizado com sucesso.</ResponseMessage>

</InputBlock>

<ResponseMessage>NFS-e Processada 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	CustomId	Identificador customizado informado no envio
4	B02	ResponseCode	Código de resposta do processamento	A01	N	S	-
5	B03	ResponseMessage	Mensagem referente ao ResponseCode	A01	C	S	-
6	A02	Document	Grupo com informações do documento processado	RAIZ	C	S	-
7	B03	Id	Identificador do documento	A02	N	S	-
8	B04	ResponseCode	Código de resposta do processamento	A02	N	S	FIXO
	B05	ResponseMessage	Mensagem referente ao ResponseCode	A02	GUID	S	FIXO

•Identificador dos documentos:

oProcessamento com Sucesso: Tipo Do Documento + Numero do Documento + CNPJ do Transportador/Prestador + Código IBGE do Múnicipio da prestação onde:

•Tipo do Documento (1 Dígito):

1.Autorização;

2.Cancelamento;

•Numero do Documento: 15 Dígitos

•CNPJ do Transportador: 14 Dígitos;

•Código IBGE do Municipio de Prestação: 7 Dígitos

oProcessamento com Inconsistência, quando informado o nome do documento(Envio de arquivo compactado):

▪Nome: Nome do documento informado.

oProcessamento com Inconsistência, quando o envio é feito pelo embarcador e não informado o nome do documento(Envio do xml):

▪Data: Data que o arquivo foi internalizado.

oProcessamento com Inconsistência, quando o envio é feito pelo transportador e não informado o nome do documento(Envio do xml):

▪CNPJTransp: CNPJ do transportador que enviou a requisição.

▪Data: Data que o arquivo foi internalizado.

oProcessamento com Erro, quando informado o nome do documento(Envio de arquivo compactado):

▪Nome: Nome do documento informado.

oProcessamento com Erro, quando o envio é feito pelo embarcador e não informado o nome do documento(Envio do xml):

▪Data: Data que o arquivo foi internalizado.

oProcessamento com Erro, quando o envio é feito pelo transportador e não informado o nome do documento(Envio do xml):

▪CNPJTransp: CNPJ do transportador que enviou a requisição.

▪Data: Data que o arquivo foi internalizado.

Códigos Retorno do Cabeçalho da Mensagem

Código	Mensagem
410	Processamento realizado com sucesso

Códigos Retorno do Corpo da Mensagem

Código	Mensagem
200	NFS-e processada com sucesso
201	Mapeamento não encontrado
202	Identificador do mapeamento não encontrado
203	Falha na execução do mapeador
204	Filial/Tomador CNPJ $ não cadastrado no nddFrete
214	NFSe normal relacionada não encontrada
242	Transportador CNPJ $ não cadastrado no nddFrete
243	Valor do ISS não é igual ao valor da Base de Cálculo multiplicado por Alíquota considerando Tolerância
244	NFS-e com Retenção de ISS deve possuir Valor Total igual da Base de Cálculo deduzida do ISS Retido
245	Código do Município da Prestação do Serviço inválido
246	Não foi possível localizar a NFS-e Normal relacionada: {Número da NFS-e}
247	NFS-e Cancelada em {Data do cancelamento}
248	Não foi possível realizar a conversão de data
249	Valor da NFS-e maior que o valor dos serviços
250	Embarque não encontrado
251	Serviço vínculado a NFS-e relacionado a embarques cancelados

A consulta lista do XML de NFS-es dos documentos disponíveis do nddFrete conciliados e não vinculados a eventos e ao faturamento, visa relacionar ao responsável pela requisição da mesma os identificadores dos pacotes ainda não consumidos pelo solicitante.

Os documentos disponíveis para consulta são:

Tipo do Documento	ProcessCode
Nota Fiscal de Serviço (NFS-e)	4302

Crosstalk de Envio (parâmetro header)

</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: o4302 Consulta Lista de CT-e	A01	N	S	-
4	B02	MessageType	Tipo da operação: 103	A01	N	S	FIXO
5	B03	ExchangePattern	TIpo da mensagem: 1 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

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 é retornado falha de schema. Se algum dos campos obrigatórios não estiver no formato correto, a mensagem de retorno critica o mesmo. Sendo processada com sucesso, no corpo da mensagem apresenta a lista de identificadores para o participante que fez a solicitação.

Retorno da solicitação

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

</CrosstalkHeader>

</ListResponse>]]></RawData>

</CrosstalkBody>

</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	FIXO
5	B03	ExchangePattern	TIpo da mensagem informada no envio	A01	N	S	FIXO
6	B04	Guid	Identificador Único da Mensagem	A01	GUID	S	-
7	B05	EnterpriseId	Identificador do transportador informado no envio	A01	GUID	S	FIXO
8	B06	Token	Token para autenticação do cliente 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	-

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.
205	A mensagem foi processada com sucesso.	Solicitação de envio do documento processada com sucesso.
210	ProcessCode e MessageType inválido	O ProcessCode ou o MessageType informados não existem na aplicação nddFrete.
214	A mensagem foi rejeitada porque o embarcador não foi informado ou não está cadastrado.	O EnterpriseId e o Token informado não existem na aplicação nddFrete.
215	A consulta não retornou nenhum resultado.	O GUID da mensagem já existir na aplicação nddFrete.
999	Ocorreu um erro inesperado no processamento da mensagem.	Erro não catalogado.

Pedido de download de documento

A integração disponibilizada para busca de documentos é um processo assíncrono, a captura de um documento específico solicitado no momento da requisição ao serviço de integração do nddFrete. Para isso, é necessário informar na chamada de solicitação do documento o identificador do documento que se deseja obter. Este identificador deve ter sido retornado previamente através da consulta da lista de documentos.

Ao receber a lista de identificadores, a aplicação nddFrete localiza em sua base de dados os documentos relacionados à cada pacote, processa-os, monta a mensagem de reposta e marca os documentos como consumidos. Os documentos processados são retornados na busca da resposta da primeira requisição.

A primeira chamada é o Pedido de Download, que deve receber dois parametros: O Crosstalk de Envio e a Lista de identificadores.

Tipo do Documento	ProcessCode
NFS-e (Nota Fiscal de Serviço)	4303

Crosstalk de Envio (parâmetro header)

</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: o4303 Pedido de Download de NFS-e	A01	N	S	-
4	B02	MessageType	Tipo da operação: 103	A01	N	S	FIXO
5	B03	ExchangePattern	TIpo da mensagem: 1 Envio	A01	N	S	FIXO
6	B04	EnterpriseId	Identificador do transportador ou operador logístico	A01	GUID	S	FIXO
7	B05	Token	Token para autenticação do cliente ou operador logístico	A01	GUID	S	FIXO
8	B06	ContentType	Formato da mensagem enviada: text/xml	A01	C	S	FIXO

Solicitação de Pacote - Lista de identificadores (parâmetro rawdata)

</DataRequest>

Detalhamento da Consulta

#	ID	CAMPO	DESCRIÇÃO	PAI	TIPO	OBR.	OBS.
1	RAIZ	DataRequest	Tag raiz da mensagem	-	-	S	FIXO
2	A01	Id	Identificador do Pacote	RAIZ	-	S	FIXO

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	FIXO
5	B03	ExchangePattern	TIpo da mensagem informada no envio	A01	N	S	FIXO
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	-

O retorno obtido na primeira requisição do processo assíncrono, informa se a mensagem foi processada 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.

Consulta do Processamento (parâmetro header)

<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	FIXO
5	B03	ExchangePattern	TIpo da mensagem informada no envio	A01	N	S	FIXO
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

A consulta com o ExchangePattern 8 retorna se a solicitação foi processada ou ainda está em processamento.

Retorno do Processamento - conteúdo do download

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

</CrosstalkHeader>

<Data>

<NFSe>

<MunicipioPrestacaoDescricao>LAGES/SC</MunicipioPrestacaoDescricao>

</DadosComplementaresServico>

</Servicos>

<Endereco>DR WALMOR RIBEIRO 514</Endereco>

<Bairro>CORAL</Bairro>

</EnderecoPrestador>

</DadosComplementaresPrestador>

</Prestador>

<RazaoSocial>NDD - FILIAL</RazaoSocial>

</IdentificacaoTomador>

<Endereco>DR WALMOR RIBEIRO</Endereco>

<Bairro>CORAL</Bairro>

</EnderecoTomador>

</Tomador>

</InfRps>

</ValoresServico>

</InfNfse>

</NFSe>

</Data>

</Element>

</DataResponse>]]]]></RawData>

</CrosstalkBody>

</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	FIXO
5	B03	ExchangePattern	TIpo da mensagem informada no envio	A01	N	S	FIXO
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	C01	RawData	Documento Solicitado	-	C	N	-

Códigos de Retorno da Solicitação de Processamento

Código	Mensagem	Situação
200	A mensagem foi recebida e está sendo processada.	Solicitação do envio processada com sucesso.
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.
205	A mensagem foi processada com sucesso.	Solicitação de envio do documento processada com sucesso.
210	ProcessCode e MessageType inválido	O ProcessCode ou o MessageType informados não existem na aplicação nddFrete.
999	Ocorreu um erro inesperado no processamento da mensagem.	Erro não catalogado.