Consulta de rastreio
Consulte informações sobre onde o cartão se encontra.
Passos para Integrar
- Realizar autenticação na API.
- Ter um cartão emitido na Celcoin e realizar a consultar na API.
- Receber as informações de onde o cartão se encontra.
Consulta de Rastreio
Para consultar as informações sobre onde o cartão se encontra, após a autenticação, é necessário realizar a seguinte requisição:
cURL da chamada
curl --request GET \
--url https://sandbox-apicorp.celcoin.com.br/cards/v1/accounts/{accountId}/customers/{customerId}/card/{cardId}/embossing \
--header 'Authorization: Bearer {TOKEN}' \
--header 'Content-Type: application/json' \
--header 'User-Agent: insomnia/10.0.0'
Sucesso 200
{
"version": false,
"status": 200,
"body": {
"cardId": 1971,
"embossingCustomField": "TRACKING_NUMBER=BRL00001971CO;CENTRO_DE_CUSTO=12560;CARD_DESIGN=1685712000000;PACKAGE_DESIGN=1685722000000;DESTINATARIO_ENTREGA=Moses Lakin;",
"embossingStart": true,
"embossingFinish": false,
"embossingGroup": null,
"embossingFileName": null,
"processingDate": null,
"address": null,
"embosserName": null,
"validationResults": null,
"embossingCounter": 0,
"collectionDeliveryDate": null,
"expectedDeliveryDate": null,
"postingDeliveryDate": null,
"resolutionDate": null,
"bodyDelivery": null,
"deliveryStatus": "SOLICITADO",
"deliveryTracking": null
}
}
Significado dos objetos
| Campo | Tipo | Descrição |
|---|---|---|
| cardId | int | Id do cartão emitido |
| embossingGroup | string (100) | Esse campo informa o grupo ao qual o embossing consultado faz parte. Poderá ser nulo sempre que um grupo de embossing não existir. |
| embossingFileName | string (250) | Nome do Arquivo gerado para embossing |
| address | object | O endereço de entrega do cartão |
| embosserName | string (20) | Nome da Embossadora que emitiu o cartão |
| validationResults | string (50) | Retorna uma mensagem informando o resultado do embossing. Null quando foi embossado com sucesso |
| embossingCounter | int | Contador de vezes em que o cartão foi reemitido |
| deliveryStatus | string | Indica em qual estágio encontra-se o cartão. |
| deliveryTracking | object | Mostra os detalhes do rastreio |
Possíveis retornos do campo statusEntrega
| Retorno | Descrição |
|---|---|
| SOLICITADO | Quando o cartão é criado e entra na fila para o processo de fabricação |
| EMBOSSING GERADO | Quando o cartão já foi fabricado com sucesso |
| COLETADO | Quando é iniciado o processo logístico após fabricação do cartão |
| POSTADO | Significa que a encomenda foi despachada em uma agência |
| ENTREGA EM ANDAMENTO | A entrega está em andamento até o destinatário |
| ENTREGUE | Foi entregue no destino final |
| DEVOLVIDO | Foi recusado no destino final |
| EXTRAVIADO | Cartão foi extraviado |
| DESTRUIDO | Cartão foi avariado |
Updated about 2 months ago