Integração de parceiro logístico com BSeller

1. Objetivo

O conteúdo abaixo, descreve  como realizar a integração com  BSeller através da obtenção de dados via API  e inclusão de ocorrências de transporte.

2 – Pré-Requisito

Para utilizar a API,  precisa informar o token correspondente a companhia desejada.

Para obter o token, basta abrir um chamado para o suporte solicitando o token e  mencionando a qual cliente(companhia) se refere.

3 – Coleta das informações da entrega

O processo realizado via API para coleta de dados do pedido consiste em 3 etapas:

3.1 Listagem de entregas:

http://api.bseller.com.br/swagger-ui.html#!/entregas/listarPedidoEntregueUsingGET

Realiza a listagem de todas as entregas (entrega e número de pedido) que atingirem o ponto ETR (pedido expedido e entregue ao transportador).

3.2 Confirmação de leitura da listagem de pedidos:      

http://api.bseller.com.br/swagger-ui.html#!/entregas/confirmarConsultaLoteUsingPUT

Realiza a confirmação de leitura do conjunto de pedidos listados no tópico 1, fazendo que os pedidos já processados não sejam listados novamente ao realizar a próxima leitura.

3.3 Listagem completa dos dados do pedido (entrega):

http://api.bseller.com.br/swagger-ui.html#!/entregas/consultaPedidoEntregaUsingGET

Após listar as entregas através dos tópicos anteriores, é  possível informar o ID da entrega e listar os dados completos de cada uma pontualmente.

4. Ocorrências de transporte:

4.1 Ids Mapeados  e criados automaticamente:

https://bseller.zendesk.com/hc/pt-br/articles/7445800654619-TMS-Ocorr%C3%AAncia-mapeada-entre-Bseller-e-Intelipost

Nesse artigo, podemos visualizar os ID’s mapeados hoje entre BSeller e Intelipost e BSeller e UX.

4.2 API para inserção de ocorrências:

http://api.bseller.com.br/swagger-ui.html#!/ocorrencias/inserirOcorrenciaIntelipostUsingPOST

Uma vez que a transportadora estiver configurada dentro do sistema, e a entrega estiver expedida, ela estará apta a receber as ocorrências de transportadora através dessa API.

5. Fluxograma:

5.1 Obter de dados da entrega:

5.1 Inserir ocorrência(s):

* Ao inserir uma ocorrência finalizadora, está indicando que o processo de entrega do pedido chegou em seu status final, podendo ser por motivo de entregue ao cliente, extravio, roubo ou até mesmo o insucesso de entrega. Uma vez inserido essa ocorrência, não é permitido incluir ocorrências posterior a ele.