A consulta disponibiliza a lista de identificadores relacionados a RPA não consumidos pelo solicitante, para disponibilização ao embarcador.
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4312</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>1</ExchangePattern> <EnterpriseId>FB7BB156-4370-4DE5-AEA8-5BA1C93EC4B5</EnterpriseId> <Token>A4C3E8D4-E855-4AAF-BC77-CE7ACEA990C6</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: o4312 Consulta Lista de PA disponíveis. |
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 do embarcador |
A01 |
GUID |
S |
FIXO |
7 |
B05 |
Token |
Token para autenticação do embarcador |
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 |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4312</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <Guid>a5d0b06a-a9be-47a3-b726-e064fa96e38a</Guid> <EnterpriseId>16d043a5-d512-4adc-ab78-12515e25c5b6</EnterpriseId> <Token>e4693f3b-c0e7-4888-b12d-41f2eb85cee6</Token> <ContentEncoding>UTF-8</ContentEncoding> <ContentType>txt/xml</ContentType> <ResponseCode>205</ResponseCode> <ResponseMessage>A mensagem foi processada com sucesso.</ResponseMessage> </CrosstalkHeader> <CrosstalkBody> <RawData> <ListResponse Version="1.0"> <Id>PA_EMI_42</Id> </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 embarcador informado no envio |
A01 |
GUID |
S |
FIXO |
8 |
B06 |
Token |
Token para autenticação do embarcador 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 |
- |
O prefixo gerado para os identificadores retornados da consulta da lista é configurado nos dados de mapeamento do embarcador.
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. |
Download de RPA |
|---|
A integração disponibilizada para busca de provisão é 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
Crosstalk de Envio (parâmetro header) |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4313</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <EnterpriseId>FB7BB156-4370-4DE5-AEA8-5BA1C93EC4B5</EnterpriseId> <Token>A4C3E8D4-E855-4AAF-BC77-CE7ACEA990C6</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: o4313 Pedido de Download de PA |
A01 |
N |
S |
- |
4 |
B02 |
MessageType |
Tipo da operação: 103 |
A01 |
N |
S |
FIXO |
5 |
B03 |
ExchangePattern |
TIpo da mensagem: 7 Envio |
A01 |
N |
S |
FIXO |
6 |
B04 |
EnterpriseId |
Identificador do embarcador |
A01 |
GUID |
S |
FIXO |
7 |
B05 |
Token |
Token para autenticação do embarcador |
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 Version = "1.0"> <Id>PA_EMI_49</Id> </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 |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4313</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>7</ExchangePattern> <Guid>c7f6be98-359c-4ddf-a2f9-d3bc3149a7a1</Guid> <EnterpriseId>fb7bb156-4370-4de5-aea8-5ba1c93ec4b5</EnterpriseId> <Token>a4c3e8d4-e855-4aaf-bc77-ce7acea990c6</Token> <ContentEncoding>UTF-8</ContentEncoding> <ContentType>txt/xml</ContentType> <ResponseCode>200</ResponseCode> <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 do embarcador |
A01 |
GUID |
S |
FIXO |
8 |
B06 |
Token |
Token para autenticação do embarcador |
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) |
|---|
<CrosstalkMessage><CrosstalkHeader> <ProcessCode>4313</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>8</ExchangePattern> <Guid>f936299c-75b3-40a3-a2a8-3252a4c6c3f3</Guid> <EnterpriseId>16d043a5-d512-4adc-ab78-12515e25c5b6</EnterpriseId> <Token>e4693f3b-c0e7-4888-b12d-41f2eb85cee6</Token> <ContentEncoding>UTF-8</ContentEncoding> <ContentType>txt/xml</ContentType> </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 retornada do envio |
A01 |
GUID |
S |
- |
7 |
B05 |
EnterpriseId |
Identificador do embarcador informado no envio |
A01 |
GUID |
S |
FIXO |
8 |
B06 |
Token |
Token para autenticação do embarcador 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 |
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 |
|---|
<CrosstalkMessage> <CrosstalkHeader> <ProcessCode>4313</ProcessCode> <MessageType>103</MessageType> <ExchangePattern>8</ExchangePattern> <Guid>dadfe5b9-280a-49d0-b80b-520915557255</Guid> <EnterpriseId>16d043a5-d512-4adc-ab78-12515e25c5b6</EnterpriseId> <Token>e4693f3b-c0e7-4888-b12d-41f2eb85cee6</Token> <ContentEncoding>UTF-8</ContentEncoding> <ContentType>txt/xml</ContentType> <ResponseCode>205</ResponseCode> <ResponseMessage>A mensagem foi processada com sucesso.</ResponseMessage> </CrosstalkHeader> <CrosstalkBody> <RawData> <DataResponse Version="1.0"> <Element> <Id>RPA_EMI_101</Id> <Data> <RetornoConsultaRPA> <NRPA>101</NRPA> <SerieRPA>105</SerieRPA> <DtEmissao>2019-02-20T09:50:51.847</DtEmissao> <DtAgendamentoPaga>2019-02-23T00:00:00</DtAgendamentoPaga> <DadosTomador> <RazaoSocial>NDDigital</RazaoSocial> <CNPJ>25512677000130</CNPJ> <Endereco> <Logradouro>Walmor Ribeiro</Logradouro> <Numero>312</Numero> <Bairro>Walmor Ribeiro</Bairro> <Cidade>Lages</Cidade> <UF>SC</UF> <CodCidade>2800308</CodCidade> </Endereco> </DadosTomador> <DadosTransportador> <Nome>Transportador</Nome> <CPF>01016473000140</CPF> <InscInss>1000</InscInss> <RetInssOutraEmpresa>0</RetInssOutraEmpresa> <Endereco> <Logradouro>RUA ALTO DA BOA VISTA 32455</Logradouro> <Bairro>SAGRADO</Bairro> <Cidade>Alecrim</Cidade> <UF>SC</UF> <Complemento>complemento</Complemento> <CodCidade>2919553</CodCidade> </Endereco> </DadosTransportador> <DadosRemetente> <RazaoSocial>RAZAO SOCIAL NDD</RazaoSocial> <Id>08608166903</Id> <Endereco> <Logradouro>RUA ALTO DA BOA VISTA</Logradouro> <Bairro>BAIRRO</Bairro> <Cidade>Alecrim</Cidade> <UF>SC</UF> <Complemento>BLOCO C</Complemento> <CodCidade>2919553</CodCidade> </Endereco> </DadosRemetente> <DadosDestinatario> <RazaoSocial>NDDigital</RazaoSocial> <CNPJ>25512677000130</CNPJ> <Endereco> <Logradouro>Rua</Logradouro> <Bairro>Bairro</Bairro> <Cidade>Lages</Cidade> <UF>SC</UF> <CodCidade>2800308</CodCidade> </Endereco> </DadosDestinatario> <ValoresRPA> <VlrBrutoPaga>870.00</VlrBrutoPaga> <VlrLiquidoPaga>846.51</VlrLiquidoPaga> <TotalDescontos>23.49</TotalDescontos> <VlrImpostos> <Inss> <ValorBase>174.00</ValorBase> <Aliquota>11.00</Aliquota> <Valor>19.14</Valor> <ValorAcumulado>38.2800</ValorAcumulado> </Inss> <Irrf> <ValorBase>67.86</ValorBase> <Aliquota>0.00</Aliquota> <Valor>0.00</Valor> </Irrf> <Sest> <ValorBase>174.00</ValorBase> <Aliquota>1.00</Aliquota> <Valor>1.74</Valor> </Sest> <Senat> <ValorBase>174.00</ValorBase> <Aliquota>1.50</Aliquota> <Valor>2.61</Valor> </Senat> </VlrImpostos> </ValoresRPA> <FormaPagamento>2</FormaPagamento> <DocumentosOriginarios/> </RetornoConsultaRPA> </Data> </Element> </DataResponse> </RawData> </CrosstalkBody> </CrosstalkMessage> |
Quando processada, vai retornar o conteúdo do documento dentro da tag Element, conforme layout abaixo:
Documento |
Tipo |
Manual de formação |
Exemplo |
RPA |
Layout de RPA NDD |
# |
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. |