# Requisição de Rastreamento Independente de qual transportadora você vá consultar, a requisição obedece sempre o mesmo padrão. {% hint style="danger" %} [**Não se esqueça**: você deve enviar o `token` e `appkey` no header da sua requisição.](/intergrando-logapi/autenticacao.md) {% endhint %} ## Endpoint da requisição Você deve submeter uma requisição **GET** para a LogAPI: {% code title="Endpoint de produção" fullWidth="false" %} ```url https://api.logapi.com.br/tracking ``` {% endcode %} ## Payload padrão da requisição No json da requisição, você deve enviar sempre três chaves comuns. [Consulte o endpoint de transportadoras para saber quais os nomes e os dados necessários para cada uma. ](/intergrando-logapi/transportadoras.md) * **`carrierName`** deve informar qual transportadora você deseja consultar. * **`trackingIdentifiers`** deve informar qual o dado de rastreamento você possuí. Cada transportadora tem os seus, mas sempre usamos as mesmas variaveis: * **`trackingCode`** é o código de rastreamento da entrega. * **`invoiceNumber`** é o numero da nota fiscal * **`invoiceSeries`** é a série da nota fiscal * **`invoiceKey`** é a chave de 44 dígitos da nota fiscal * **`credentials`** dados de credenciamento da API da transportadora. ### Exemplo de payload: ```json { "carrierName": "loggi", "trackingIdentifiers": { "trackingCode": "EBW2NR3T" }, "credentials": { "client_id": "CLIENT_ID_LOGGI", "client_secret": "CLIENT_SECRET_LOGGI", "company_id": "COMPANY_ID_LOGGI" } } ``` ### Exemplo de requisição completa cURL: ```http curl --location 'https://api.logapi.com.br/tracking' \ --header 'token: SEU_TOKEN' \ --header 'appkey: APP_KEY_DO_SEU_APLICATIVO' \ --header 'Content-Type: application/json' \ --data '{ "carrierName": "loggi", "trackingIdentifiers": { "trackingCode": "EBW2NR3T" }, "credentials": { "client_id": "CLIENT_ID_LOGGI", "client_secret": "CLIENT_SECRET_LOGGI", "company_id": "COMPANY_ID_LOGGI" } }' ``` ### Exemplo de requisição e retorno `GET``https://api.logapi.com.br/tracking` \ **Headers** | Name | Value | | ------------ | ------------------ | | Content-Type | `application/json` | | token | `` | | appkey | `` | **Body** | Name | Type | Description | | --------------------- | ------ | ----------------------------------------------------------------------------------------------------------- | | `carrierName` | string | Nome da transportadora | | `trackingIdentifiers` | object | Dados para rastreamento | | `credentials` | object |

Credenciais de autenticação da transportadora.

Opcional, caso você cadastre no painel LogAPI.

| **Response** {% tabs %} {% tab title="200" %} ```json { "shipmentDetails": { "carrier": "Gol Log", "cost": { "value": 0, "unit": "cents" }, "trackingCode": "12721182618", "type": "E-COMMERCE", "deliveryEstimate": { "date": "2024-11-11", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00" }, "invoice": { "number": "000017751", "series": "", "key": "", "total": 0, "totalUnit": "cents" }, "cte": "", "sender": { "name": "", "email": "", "mobile": "", "document": "", "address": "", "number": "", "complement": "", "neighborhood": "", "city": "", "state": "", "postalCode": "" }, "recipient": { "name": "", "email": "", "mobile": "", "phoneNumber": "", "document": "", "address": "", "number": "", "complement": "", "neighborhood": "", "city": "", "state": "", "postalCode": "" }, "weight": { "value": 0.592, "unit": "grams" }, "dimensions": { "length": { "value": 0, "unit": "cm" }, "width": { "value": 0, "unit": "cm" }, "height": { "value": 0, "unit": "cm" } }, "volume": { "value": 0, "unit": "cm³" }, "carrierLogo": "https://api.logapi.com.br/public/carrier/gol-log.png", "postDate": { "date": "2024-11-04T15:11:59-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00" } }, "tracking": [ { "date": "2024-11-04T15:11:59-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Emitida", "description": "1 volume foi recebido na loja GOLLOG - QHV", "location": "QHV - RS", "status": "Posted", "details": { "statusText": "Postado", "description": "O pacote foi postado e iniciou seu trajeto.", "toDo": "Aguardar atualização de status." } }, { "date": "2024-11-04T15:16:46-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Manifestada", "description": "1 volume foi manifestado no transporte G38953t", "location": "QHV - RS", "status": "InTransit", "details": { "statusText": "Em Trânsito", "description": "O pacote está em movimento entre as unidades de logística.", "toDo": "Aguardar atualização de status." } }, { "date": "2024-11-04T19:45:04-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Despachada", "description": "1 volume está em transferência de QHV para POA no transporte G38953t", "location": "QHV - RS", "status": "InTransit", "details": { "statusText": "Em Trânsito", "description": "O pacote está em movimento entre as unidades de logística.", "toDo": "Aguardar atualização de status." } }, { "date": "2024-11-04T19:45:34-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Recebimento em base intermediária", "description": "1 volume foi recebido na unidade POA no transporte G38953t para conexão", "location": "POA - RS", "status": "InTransit", "details": { "statusText": "Em Trânsito", "description": "O pacote está em movimento entre as unidades de logística.", "toDo": "Aguardar atualização de status." } }, { "date": "2024-11-05T04:10:33-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Manifestada", "description": "1 volume foi manifestado no transporte G31247", "location": "POA - RS", "status": "InTransit", "details": { "statusText": "Em Trânsito", "description": "O pacote está em movimento entre as unidades de logística.", "toDo": "Aguardar atualização de status." } }, { "date": "2024-11-05T17:24:03-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Despachada", "description": "1 volume está em transferência de POA para GRU no transporte G31247", "location": "POA - RS", "status": "InTransit", "details": { "statusText": "Em Trânsito", "description": "O pacote está em movimento entre as unidades de logística.", "toDo": "Aguardar atualização de status." } }, { "date": "2024-11-05T21:42:44-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Recebimento em base intermediária", "description": "1 volume foi recebido na unidade GRU no transporte G31247 para conexão", "location": "GRU - RS", "status": "InTransit", "details": { "statusText": "Em Trânsito", "description": "O pacote está em movimento entre as unidades de logística.", "toDo": "Aguardar atualização de status." } }, { "date": "2024-11-06T13:19:38-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Saiu para entrega", "description": "1 volume em processo de entrega ao destinatário", "location": "QGL - RS", "status": "OutForDelivery", "details": { "statusText": "Saiu para Entrega", "description": "O pacote saiu para ser entregue", "toDo": "Certificar-se de que alguém está disponível para receber." } }, { "date": "2024-11-06T11:03:52-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Despachada", "description": "1 volume está em transferência de GRU para QGL no transporte G31925D", "location": "GRU - RS", "status": "InTransit", "details": { "statusText": "Em Trânsito", "description": "O pacote está em movimento entre as unidades de logística.", "toDo": "Aguardar atualização de status." } }, { "date": "2024-11-06T11:30:26-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Recebida no destino", "description": "1 volume desembarcado no destino QGL no transporte G31925D", "location": "QGL - RS", "status": "InTransit", "details": { "statusText": "Em Trânsito", "description": "O pacote está em movimento entre as unidades de logística.", "toDo": "Aguardar atualização de status." } }, { "date": "2024-11-06T12:21:53-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Saiu para entrega", "description": "1 volume em processo de entrega ao destinatário", "location": "QGL - RS", "status": "OutForDelivery", "details": { "statusText": "Saiu para Entrega", "description": "O pacote saiu para ser entregue", "toDo": "Certificar-se de que alguém está disponível para receber." } }, { "date": "2024-11-06T07:57:32-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Manifestada", "description": "1 volume foi manifestado no transporte G31925D", "location": "GRU - RS", "status": "InTransit", "details": { "statusText": "Em Trânsito", "description": "O pacote está em movimento entre as unidades de logística.", "toDo": "Aguardar atualização de status." } }, { "date": "2024-11-07T14:06:57-03:00", "timezone": "America/Sao_Paulo", "utcOffset": "-03:00", "title": "Entrega", "description": "1 volume recebido em domicílio por Marluce Teles ", "location": "QGL - RS", "status": "Delivered", "details": { "statusText": "Entregue", "description": "O pacote foi entregue ao destinatário.", "toDo": "Confirmar se foi recebido corretamente." } } ], "originalData": [ { "found": true, "showEvents": false, "header": { "code": "12728182611", "nf": "000017571", "reference": "145035746", "service": "ECG", "serviceName": "E-COMMERCE", "pieces": 1, "weight": 0.592 }, "routing": { "origin": { "code": "QHV", "name": "FRG LOGISTICA EIRELI - EPP", "document": "27971339000191", "phoneNumber": "(51) 30354611", "email": "qhvfk@voegol.com.br", "address": "Rua Sete de Setembro", "addressNumber": "660", "addressComplement": null, "postalCode": "93334174", "city": "NOVO HAMBURGO", "state": "RS", "country": "BRA", "availableForBooking": "true", "linkedAirportCode": "POA", "officeHours": [ { "name": "Manhã", "from": "9:00 AM", "to": "12:00 PM" }, { "name": "Tarde", "from": "12:01 PM", "to": "6:00 PM" }, { "name": "Noite", "from": "6:01 PM", "to": "7:15 PM" } ], "latitude": "-29.7124837", "longitude": "-51.1427524", "distance": 0 }, "destination": { "code": "QGL", "name": "N. D TRANSPORTES E LOGISTICA LTDA - ME", "document": "03581953000189", "phoneNumber": "(11) 20912246", "email": "qglfk@voegol.com.br", "address": "Rua Rupiara", "addressNumber": "20", "addressComplement": null, "postalCode": "03443020", "city": "SÃO PAULO", "state": "SP", "country": "BRA", "availableForBooking": "true", "linkedAirportCode": "GRU", "officeHours": [ { "name": "Manhã", "from": "9:00 AM", "to": "12:00 PM" }, { "name": "Tarde", "from": "12:01 PM", "to": "6:00 PM" } ], "latitude": "-23.542482", "longitude": "-46.536933", "distance": 0 } }, "events": [ { "agent": "NOME DO AGENTE", "pid": "197970357", "date": "2024-11-07T14:06:57Z", "code": "DLV", "codeDescription": "Entrega", "station": "QGL", "arrivalPoint": null, "message": "1 volume recebido em domicílio por Marluce Teles ", "scheduleType": null }, { "agent": "NOME DO AGENTE", "pid": "197740089", "date": "2024-11-06T07:57:32Z", "code": "MAN", "codeDescription": "Manifestada", "station": "GRU", "arrivalPoint": "QGL", "message": "1 volume foi manifestado no transporte G31925D", "scheduleType": "Surface" }, { "agent": "NOME DO AGENTE", "pid": "197782668", "date": "2024-11-06T12:21:53Z", "code": "OND", "codeDescription": "Saiu para entrega", "station": "QGL", "arrivalPoint": null, "message": "1 volume em processo de entrega ao destinatário", "scheduleType": null }, { "agent": "NOME DO AGENTE", "pid": "197775124", "date": "2024-11-06T11:30:26Z", "code": "RCF", "codeDescription": "Recebida no destino", "station": "QGL", "arrivalPoint": "QGL", "message": "1 volume desembarcado no destino QGL no transporte G31925D", "scheduleType": "Surface" }, { "agent": "NOME DO AGENTE", "pid": "197771044", "date": "2024-11-06T11:03:52Z", "code": "DEP", "codeDescription": "Despachada", "station": "GRU", "arrivalPoint": "QGL", "message": "1 volume está em transferência de GRU para QGL no transporte G31925D", "scheduleType": "Surface" }, { "agent": "NOME DO AGENTE", "pid": "197789985", "date": "2024-11-06T13:19:38Z", "code": "OND", "codeDescription": "Saiu para entrega", "station": "QGL", "arrivalPoint": null, "message": "1 volume em processo de entrega ao destinatário", "scheduleType": null }, { "agent": "NOME DO AGENTE", "pid": "197682904", "date": "2024-11-05T21:42:44Z", "code": "CIE", "codeDescription": "Recebimento em base intermediária", "station": "GRU", "arrivalPoint": "GRU", "message": "1 volume foi recebido na unidade GRU no transporte G31247 para conexão", "scheduleType": "Air" }, { "agent": "NOME DO AGENTE", "pid": "197649912", "date": "2024-11-05T17:24:03Z", "code": "DEP", "codeDescription": "Despachada", "station": "POA", "arrivalPoint": "GRU", "message": "1 volume está em transferência de POA para GRU no transporte G31247", "scheduleType": "Air" }, { "agent": "NOME DO AGENTE", "pid": "197544261", "date": "2024-11-05T04:10:33Z", "code": "MAN", "codeDescription": "Manifestada", "station": "POA", "arrivalPoint": "GRU", "message": "1 volume foi manifestado no transporte G31247", "scheduleType": "Air" }, { "agent": "NOME DO AGENTE", "pid": "197504914", "date": "2024-11-04T19:45:34Z", "code": "CIE", "codeDescription": "Recebimento em base intermediária", "station": "POA", "arrivalPoint": "POA", "message": "1 volume foi recebido na unidade POA no transporte G38953t para conexão", "scheduleType": "Surface" }, { "agent": "NOME DO AGENTE", "pid": "197504441", "date": "2024-11-04T19:45:04Z", "code": "DEP", "codeDescription": "Despachada", "station": "QHV", "arrivalPoint": "POA", "message": "1 volume está em transferência de QHV para POA no transporte G38953t", "scheduleType": "Surface" }, { "agent": "NOME DO AGENTE", "pid": "197471842", "date": "2024-11-04T15:16:46Z", "code": "MAN", "codeDescription": "Manifestada", "station": "QHV", "arrivalPoint": "POA", "message": "1 volume foi manifestado no transporte G38953t", "scheduleType": "Surface" }, { "agent": "NOME DO AGENTE", "pid": "197471249", "date": "2024-11-04T15:11:59Z", "code": "RCS", "codeDescription": "Emitida", "station": "QHV", "arrivalPoint": null, "message": "1 volume foi recebido na loja GOLLOG - QHV", "scheduleType": null } ], "originAdvancedPost": "QHV - SALGADO FILHO (PORTO ALEGRE)", "destinationAdvancedPost": "QGL - GUARULHOS INTERNATIONAL (GUARULHOS)", "nfeCode": null, "isHomeDelivery": true, "deliveryPlace": "delivery", "isCancelled": false, "cancellationDateTime": null, "expectedDeliveryDate": "11/11", "deliveryDeadline": "11/11", "lastStatus": { "code": "DLV", "description": "1 volume recebido em domicílio por NOME", "supportedCodes": [] }, "rcs": true, "dep": true, "rcf": true, "dlv": true, "ond": true, "gre": false, "crc": false, "crcOccurredAtDestiny": false, "ccd": false, "ccdOccurredAtDestiny": false, "deliveryAddress": { "street": "RUA DO ENDEREÇO", "number": "111", "complement": "CASA X", "postalCode": "03685010", "neighborhood": "JARDIM SÃO NICOLAU", "city": "SÃO PAULO", "state": "SP", "country": "BRA" }, "trackingIdentifiers": { "awb": "5778884455", "invoiceNumber": "17175" } } ], "trackingIdentifiers": { "awb": "5778884455", "invonvoiceNumber": "15177" }, "error": false } ``` {% endtab %} {% tab title="400" %} ```json { "code": "BadRequest", "message": "Entrega não localizada no transportador" } ``` {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ajuda.logapi.com.br/intergrando-logapi/requisicao-de-rastreamento.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.