Simulação de Rastreio do Cartão

1. Criar cartão físico
   1. Utilize a documentação Emissão/Geração de Cartão
2. Após gerar o cartão é necessário aguardar o recebimento do webhook card-created antes de seguir para o passo 3.
3. Inserir registro de simulação de rastreio

   1. Utilize o endpoint Simulação de rastreamento de um cartão para incluir o registro de rastreio do cartão.

   2. Para inserir o registro será necessário informar o externalEventId no objetoevent:

      Código do evento (externalEventId)	Descrição do evento	Descrição do status agrupado
      1100	Em arquivo-aguardando Postagem	Arquivo Aguardando Postagem
      3000	OBJETO Recebido	Em Processo de Entrega
      4100	Entrega em andamento (na rua)	Em Processo de Entrega
      4300	Entrega registrada	Entregue

      
      

   3. Exemplo de Request:

POST 'https://sandbox-apicorp.celcoin.com.br/accounts/11914/customers/11917/card/17151/tracking/simulate' \

  --header 'Content-Type: application/json' \
  --header 'X-Requested-With: XMLHttpRequest' \
  --header 'Accept: application/json' \
  --header 'Client-Id: 1' \
  --header 'Authorization: Bearer X \
  --body '{
    
    "postingDate": "2026-01-15 13:30:00",
    "event": {
        "externalEventId": 1100,
        "occurrenceDate": "2026-01-15 16:30:00"
    }
}

iv. Exemplo de Response:

{
    "version": false,
    "status": 200,
    "body": {
        "cardId": 17151,
        "embossingCustomField": "TRACKING_NUMBER=BRL00117151FL;CENTRO_DE_CUSTO=14574;CARD_DESIGN=100;PACKAGE_DESIGN=001;DESTINATARIO_ENTREGA=MULTIAPP ENTIDADE HASH;MULTIAPP=1;NUMERO_IMPRESSO=1;",
        "embossingStart": true,
        "embossingFinish": true,
        "embossingGroup": null,
        "embossingFileName": "CELCOIN20260127202641_22191.pgp",
        "processingDate": "2026-01-27 20:26:48",
        "address": {
            "addressId": 12151,
            "address": "Alameda Santa Rosa",
            "number": "162",
            "neighborhood": "Portal da Amazônia",
            "city": "Rio Branco",
            "state": "AC",
            "country": "Brasil",
            "zipCode": "12952110",
            "complement": null
        },
        "embosserName": "1",
        "validationResults": null,
        "embossingCounter": 0,
        "collectionDeliveryDate": null,
        "expectedDeliveryDate": null,
        "postingDeliveryDate": "2026-01-15 13:30:00",
        "resolutionDate": null,
        "bodyDelivery": null,
        "deliveryStatus": "Arquivo Aguardando Postagem",
        "deliveryTracking": {
            "deliveryTrackingId": 88,
            "trackingCode": "BRL00117151FL",
            "events": [
                {
                    "externalEventId": 1100,
                    "occurenceDate": "2026-01-15 16:30:00",
                    "externalEventDescription": "Em arquivo-aguardando Postagem"
                }
            ]
        }
    }
}

4. Após realizar a requisição com sucesso, será enviado o webhook card-in-transit

{
  "data": {
    "type": "card-in-transit",
    "tenant_name": "ba_cartoes",
    "body": {
      "programId": "55",
      "accountId": "11914",
      "customerId": "11917",
      "cardId": "17151",
      "customerDocument": "36417635090",
      "cardLastDigits": "0699",
      "cardTrackingCode": "BRL00117151FL",
      "occurrenceDate": "2026-01-15 16:30:00",
      "externalEventId": "1100",
      "eventDescription": "Em arquivo-aguardando Postagem",
      "deliveryStatusId": "1",
      "deliveryStatusDescription": "Arquivo Aguardando Postagem",
      "collectionDate": null,
      "postingDate": "2026-01-15 13:30:00",
      "slaDate": null,
      "dischargeDate": null,
      "entity": "card-in-transit"
    }
  },
  "metadata": {
    "timestamp": "2026-01-29T19:53:02+00:00",
    "messageType": "webhook"
  }
}