A API V3 JÁ ESTÁ DISPONÍVEL
|
Adiciona evento no rastreamento
Adiciona uma atualização de evento no objeto de postagem que será listada nas informações de rastreamento do mesmo.
curl |
curl -X POST "https://bling.com.br/Api/v2/logistica/evento/{codigo_rastreamento}/json/" |
PHP |
$url = 'https://bling.com.br/Api/v2/logistica/evento/{codigo}/json'; |
C# |
public static void ExecuteSendTracking() { |
Parâmetro | Descrição | Tipo |
apikey |
apikey gerada no sistema | string |
xml |
xml contendo os dados de rastreamento | string |
Para o parâmetro xml é necessário seguir o padrão descrito na tabela abaixo.
Tabela de campos do XML
Grupo | Campo | Informação | Tipo | Padrão | Opcional | Nota |
---|---|---|---|---|---|---|
raiz | evento | Obrigatório | ||||
evento | id_servico | ID do serviço da integração logística obtido no método GET | INTEGER(10) | 9 | Obrigatório | |
evento | data_evento | Data de ocorrência do evento | DATETIME | 99/99/9999 99:99:99 | Opcional | |
evento | origem | Origem da ocorrência do evento | STRING(255) | Opcional | ||
evento | destino | Destino da ocorrência do evento | STRING(255) | Opcional | ||
evento | descricao | Descrição curta do evento | STRING(100) | Opcional | 1 | |
evento | codigo_situacao | Código da situação atual do rastreamento | INT(3) | Obrigatório | 2 | |
evento | url | URL para acesso ao histórico de atualizações de eventos | STRING(255) | Opcional | 3 |
Notas:
- Descrição curta para ser mostrada na visualização de rastros do sistema.
- Código da situação atual do rastro para ser mapeado no sistema. Deve seguir a tabela de Possíveis situações do evento.
- Adicionar tag CDATA no XML para indicar que a URL é um texto.
Possíveis situações do evento
Código | Descrição |
0 | Postado |
1 | Em andamento |
2 | Não entregue |
3 | Entregue |
4 | Aguardando retirada do destinatário |
Mensagem de erros específicos
Código | Mensagem |
---|---|
85 | Rastreamento inválido. |
86 | Código da situação inválido. |
87 | Não foi possível obter a integração logística. |
Exemplo de XML
<evento>
<id_servico>123454</id_servico>
<data_evento>20/12/2016 13:00:00</data_evento>
<origem>Bento Gonçalves</origem>
<destino>Veranópolis</destino>
<descricao>Produto entregue</descricao>
<codigo_situacao>3</codigo_situacao>
<url><![CDATA[https://websro.correios.com.br?P_COD_UNI=EXEMPLO]]></url>
</evento>