WS204 - Consultar Status do Pedido

Esta integração tem por objetivo permitir obter o status de um documento no sistema.

Autenticação

As chamadas terão autenticação a nível de transporte (Basic Authentication);
Solicite o user / password ao administrador da conta.

Características

URL

https://api.comprovei.com.br/api/1.1/documents/getStatus?cnpj&cpf&orderNumber&key&documentNumber&series&cnpjShipper&innerOrderNumber&clientOrder
Método:

GET
Parâmetro URL:
- cnpj: CNPJ do cliente
  - Exemplo: https://api.comprovei.com.br/api/1.1/documents/getStatus?cnpj=00007075000102
- cpf: CPF do cliente
  - Exemplo: https://api.comprovei.com.br/api/1.1/documents/getStatus?cpf=55411434467
- orderNumber: Número do pedido
  - Exemplo: https://api.comprovei.com.br/api/1.1/documents/getStatus?orderNumber=1905880818
- key: Chave do documento
  - Exemplo: https://api.comprovei.com.br/api/1.1/documents/getStatus?key=32190381887838000736550020002714101002714100
- documentNumber: Número do documento & cnpjShipper: CNPJ do Emissor
  - Exemplo: https://api.comprovei.com.br/api/1.1/documents/getStatus?documentNumber=271410&cnpjShipper=81887838000736
- documentNumber: Número do documento & series: Série do documento & cnpjShipper: CNPJ do Emissor
  - Exemplo: https://api.comprovei.com.br/api/1.1/documents/getStatus?documentNumber=271410&series=2&cnpjShipper=81887838000736
- clientOrder: Número do Pedido do Cliente
  - Exemplo: https://api.comprovei.com.br/api/1.1/documents/getStatus?clientOrder=115652
- innerOrderNumber: Número interno do pedido
  - Exemplo: https://api.comprovei.com.br/api/1.1/documents/getStatus?innerOrderNumber=556242
Parâmetro Data:

Sem parâmetros

Sucesso:

Código: 200
Conteúdo:

{"user_message": "Documento não encontrado.", 
"internal_message": "", 
"response_data": "", 
"code": 0, "more_info": "http://dev.comprovei.com.br"}

Código: 200
Conteúdo:

{"user_message": "1 Documento(s) encontrado(s).", 
"internal_message": "", 
"response_data": 
  [{ "Documento": 
      { "NumeroNF": "1704955", 
      "NumeroPedido": "1905880818", 
      "Nome": "TPS DIVIS. E REMANEJA", 
      "Logradouro": "ESTRADA DA BALSA 860", 
      "Bairro": null, 
      "Cidade": "BARUERI", 
      "Estado": "SP", 
      "Latitude":"-23.5113",
      "Longitude": "-46.8768", 
      "DataHora": "08/12/2016 11:13", 
      "Foto": "https://comprovei.s3.amazonaws.com/producao/uploads/WW/photo_name.jpg?AWSAccessKeyId=XXXXXXXXXX&Expires=YYYYY&Signature=ZZZZZZ", 
      "Pedidos": 
          [{"PedidoInterno" : "258963",
          "PedidoCliente": "5647521",
          "DataPedido": "21/02/2020",
          }],
      "PrevisaoEntrega":"29/02/2020 11:00",
      "CodigoStatus": "3", 
      "Status": "Entregue", 
      "CodOcorrencia":"",
      "DescricaoOcorrencia":"",
      "Rota":"ExemploWS204",
      "TipoDeRota":"ExemploDeTipo",
      "DataRota":"30/03/2020",
      "Motorista": "Vasconcelos", 
      "Placa": "BSF0758", 
      "Itens": 
          [{"Codigo": "000000000005056171",
          "Descricao": "SERRA TICOTICO DW300 220V DEWALT",
          "Quantidade": "1" }]} 
          }], 
"code": 200, 
"more_info": "http://dev.comprovei.com.br/api"}

Erro:

Código: 400
Conteúdo:

{"user_message": "Dados não foram preenchidos para busca.", 
"internal_message": "", 
"response_data": "", 
"code": 400, 
"more_info": "http://dev.comprovei.com.br" }

Código: 401
Conteúdo:

{"user_message": "",
"internal_message": "Usuário e/ou senha do desenvolvedor inválidos", 
"response_data": "", 
"code": 401, 
"more_info": "http://dev.comprovei.com.br" }

Código: 402
Conteúdo:

{"user_message": "", 
"internal_message": "Sem dados de autenticação do desenvolvedor", 
"response_data": "", 
"code": 402, 
"more_info": "http://dev.comprovei.com.br"}

Status dos documentos:

Código	Status	Descrição
0	Em Rota	Documento está em uma rota que foi iniciada
1	A caminho	Documento é o próximo a ser entregue
2	Chegou	Motorista chegou no cliente
3	Entregue	Documento entregue
4	Entregue SL	Documento entregue sem a conferencia dos itens
5	Em Pausa	Motorista fez uma pausa na viagem
6	Não entregue	Documento não foi entregue
7	Abortada	Motorista abortou a entrega
8	Coletado	Documento foi coletado
9	Não coletado	Documento não foi coletado
10	Conferindo	Itens estão sendo conferidos
11	Conferido	Itens foram conferidos
12	Sem Rota	Documento não está presente em nenhuma rota
13	Devolvido	Documento foi devolvido
14	Cancelado	Entrega foi cancelada
15	Agendado	Documento sofreu agendamento
16	Com Ajudante	Ajudante do motorista está com o documento para entrega
17	Transferido	Documento foi entregue na base após o transbordo
18	Em Transferência	Documento está a caminho da base
20	Programado	Documento tem data programada para envio