WS204 - Check Order Status

This integration aims to obtain the status of a document in the system.

Authentication

Calls will have transport-level authentication (Basic Authentication);
Request user / password from the account administrator.

Features

URL

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

GET
URL parameter:
- cnpj: Customer's CNPJ
  - Example: https://api.comprovei.com.br/api/1.1/documents/getStatus?cnpj=00007075000102
- cpf: Customer CPF
  - Example: https://api.comprovei.com.br/api/1.1/documents/getStatus?cpf=55411434467
- orderNumber: Order number
  - Example: https://api.comprovei.com.br/api/1.1/documents/getStatus?orderNumber=1905880818
- key: Document key
  - Example: https://api.comprovei.com.br/api/1.1/documents/getStatus?key=32190381887838000736550020002714101002714100
- documentNumber: Document number & cnpjShipper: Issuer's CNPJ
  - Example: https://api.comprovei.com.br/api/1.1/documents/getStatus?documentNumber=271410&cnpjShipper=81887838000736
- documentNumber: Document number & series: Document series & cnpjShipper: Issuer's CNPJ
  - Example: https://api.comprovei.com.br/api/1.1/documents/getStatus?documentNumber=271410&series=2&cnpjShipper=81887838000736
- clientOrder: Customer Order Number
  - Example: https://api.comprovei.com.br/api/1.1/documents/getStatus?clientOrder=115652
- innerOrderNumber: Internal order number
  - Example: https://api.comprovei.com.br/api/1.1/documents/getStatus?innerOrderNumber=556242
Data Parameter:

No parameters

Success:

Code: 200
Content:

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

Code: 200
Content:

{"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"}

Error:

Code: 400
Content:

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

Code: 401
Content:

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

Code: 402
Content:

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

Document status:

Code	Status	Description
0	On Route	Document is on a route that has been started
1	On the way	Document is next to be delivered
2	Arrived	Driver arrived at the customer
3	Delivered	Document delivered
4	Deliver SL	Document delivered without checking the items
5	On Pause	Driver took a break from the journey
6	Not delivered	Document was not delivered
7	Aborted	Driver aborted delivery
8	Collected	Document has been collected
9	Not collected	Document was not collected
10	Checking	Items are being checked
11	Checked	Items have been checked
12	No Route	Document is not present on any route
13	Returned	Document was returned
14	Canceled	Delivery was canceled
15	Scheduled	Document has been scheduled
16	With Helper	Driver's assistant has the document for delivery
17	Transferred	Document was delivered to the base after transshipment
18	In Transfer	Document is on its way to the base
20	Scheduled	Document has a scheduled date for sending