Consulta de Pacotes Disponíveis (NOTFIS)

Anterior
Próximo
Imprimir

Consulta de Pacotes Disponíveis (NOTFIS)

A consulta da lista de NOTFIS disponíveis visa relacionar ao responsável pela requisição os identificadores dos pacotes de embarques ainda não consumidos pelo solicitante.  Ao processar a chamada, o módulo de integração do nddFrete verifica os embarques disponíveis e associa aos mesmos um identificador, baseado em:

 

Prefixo: Elemento configurado nos dados do solicitante da requisição. Caso o solicitante seja o transportador e não possua esta configuração a mesma será buscada nos dados do Operador Logístico;

Data e hora: Data e hora da geração do pacote no formato: AAAAMMDDHHMMSSFFF;

XXX: Três últimas posições capturadas da geração de um GUID.

 

 

Prefixo_Data/Hora_XXX

Notfis_20170830102130837_4d8

Após o processamento da requisição, e de forma síncrona, são retornados pelo serviço de integração todos os pacotes ainda não consumidos pelo solicitante de chamada.

 

 

A consulta da lista de NOTFIS está disponível também ao operador logístico, porém, listas geradas a partir da consulta do operador logístico não são retornadas aos transportadores, ou seja, cada solicitante pode consumir somente as listas geradas a partir de um invoke realizado por ele.

Crosstalk de Envio

 

<CrosstalkMessage>

<CrosstalkHeader>

 <ProcessCode>4103</ProcessCode>

 <MessageType>103</MessageType>

 <ExchangePattern>1</ExchangePattern>

 <EnterpriseId>8685a465-a50e-4b42-8b26-c7e3f1fd5062</EnterpriseId>

 <Token>11e0999e-5da6-46c2-af95-671b8d2dbea9</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 para consulta de pacotes disponíveis:

o4103 - Lista de identificadores disponíveis

A01

N

S

4

B02

MessageType

Tipo da operação:

o103

A01

N

S

5

B03

ExchangePattern

TIpo da mensagem:

o1 (síncrona)

A01

N

S

6

B04

EnterpriseId

Identificador do Transportador ou operador logístico.

A01

GUID

S

7

B05

Token

Token para autenticação transportador ou operador logístico.

A01

GUID

S

8

B06

ContentType

Formato da mensagem enviada:

otext/xml

A01

C

S

 

Retorno de Envio

 

Ao realizar a consulta através do enterpriseId e token do operador logístico, no retorno da lista será considerado primeiro o prefixo configurado em cada transportador, caso não encontrado irá retornar com o prefixo do operador

 

<CrosstalkMessage>

<CrosstalkHeader>

<ProcessCode>4103</ProcessCode>

<MessageType>103</MessageType>

<ExchangePattern>1</ExchangePattern>

<Guid>663b9464-64e7-459e-9e58-ce53144a65b8</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>

</CrosstalkHeader>

<CrosstalkBody>

<RawData><![CDATA[<ListResponse Version="1.0">

<Id>QUICK_LOG_20170830102130837_4d8</Id>

<Id>QUICK_LOG_20170830102131134_3dc</Id>

<Id>QUICK_LOG_20170830102131134_fa3</Id>

<Id>QUICK_LOG_20170830102131150_681</Id>

<Id>QUICK_LOG_20170830102131150_35c</Id>

<Id>QUICK_LOG_20170830102131165_322</Id>

<Id>QUICK_LOG_20170830102131165_0cd</Id>

<Id>QUICK_LOG_20170830102131181_4cb</Id>

<Id>QUICK_LOG_20170830102131181_9bf</Id>

<Id>QUICK_LOG_20170830102131197_82d</Id>

<Id>QUICK_LOG_20170830102131197_0a8</Id>

<Id>DH_BRASIL_20170830102131212_015</Id>

<Id>QUICK_LOG_20170830102131228_879</Id>

<Id>QUICK_LOG_20170830102131243_95e</Id>

<Id>QUICK_LOG_20170830102131259_be1</Id>

<Id>QUICK_LOG_20170830102131275_3e4</Id>

<Id>QUICK_LOG_20170830102131290_269</Id>

<Id>QUICK_LOG_20170830102131306_831</Id>

</ListResponse>]]]]>><![CDATA[</RawData>

</CrosstalkBody>

</CrosstalkMessage

 

 

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.

Códigos Retorno

 

Código

Mensagem

Situação

205

A mensagem foi processada com sucesso.

Solicitação da lista de NOTFIS processada com sucesso.

210

ProcessCode e MessageType inválido

O ProcessCode ou o MessageType não estarem cadastrados no sistema.

215

A consulta não retornou nenhum resultado.

Não existem documentos disponíveis para o responsável pela requisição.

303

Dados de mapeamento não configurado.

Mapeamento de transformação da consulta não configurado no cadastro do solicitante.