Reverse Logistic

Eventos da família reverse_logistic.* notificam sobre devoluções, trocas e logística reversa.

Eventos Disponíveis

reverse_logistic.return.under_review - Devolução em análise
reverse_logistic.return.approved - Devolução aprovada
reverse_logistic.return.in_transit - Devolução em trânsito
reverse_logistic.return.canceled - Devolução cancelada
reverse_logistic.return.delivered - Devolução entregue
reverse_logistic.exchange.reserved - Troca reservada
reverse_logistic.exchange.approved - Troca aprovada
reverse_logistic.voucher.generated - Voucher gerado
reverse_logistic.refunded - Reembolsado

Estrutura do Payload

{
  "customer": {
    "id": "123456",
    "name": "João Silva",
    "email": "[email protected]",
    "document": "12345678900",
    "phone_numbers": [
      {
        "formatted_phone": "+5511999999999",
        "type": null,
        "raw_number": "999999999",
        "area_code": "11",
        "international_dialing_code": "55"
      }
    ],
    "address": {
      "street": "Rua Principal",
      "number": "123",
      "complement": "Apto 45",
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "postal_code": "01000-000"
    }
  },
  "reverse_payment": {
    "currency": "BRL",
    "total": 29990,
    "refund": 29990,
    "exchange": null,
    "reverse_payment_method": {
      "type": "credit_card",
      "brand": "visa",
      "last_digits": "1234",
      "expiration_month": "12",
      "expiration_year": "2028"
    },
    "coupons": []
  },
  "shipping": {
    "carrier": "Correios",
    "total_value": 0,
    "tracking_url": null,
    "tracking_code": null,
    "method": "PAC",
    "delivery_address": {
      "street": "Rua Principal",
      "number": "123",
      "complement": "Apto 45",
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "country": "BR",
      "postal_code": "01000-000"
    },
    "estimated_delivery_date": null,
    "estimated_delivery_time_in_days": null,
    "status": null,
    "raw_status": null
  },
  "items": [
    {
      "id": "prod_789",
      "name": "Produto Exemplo",
      "type": "product",
      "quantity": 1,
      "unit_value": 29990,
      "total_value": 29990,
      "image_url": "https://example.com/product.jpg",
      "offer_type": "main"
    }
  ]
}

Componentes do Payload

Customer

Campo	Tipo	Descrição
`id`	string \| null	ID único do cliente
`name`	string \| null	Nome completo
`email`	string \| null	E-mail
`document`	string \| null	Documento (CPF/CNPJ) apenas números
`phone_numbers`	array	Lista de telefones
`address`	object	Endereço

Phone Numbers

Campo	Tipo	Descrição
`formatted_phone`	string \| null	Telefone formatado em E.164
`type`	string \| null	Tipo do telefone
`raw_number`	string \| null	Número sem formatação
`area_code`	string \| null	Código de área (DDD)
`international_dialing_code`	string \| null	Código discagem internacional

Address

Campo	Tipo	Descrição
`street`	string \| null	Nome da rua
`number`	string \| null	Número
`complement`	string \| null	Complemento
`neighborhood`	string \| null	Bairro
`city`	string \| null	Cidade
`state`	string \| null	Estado (sigla)
`country`	string \| null	Código ISO 3166-1 alpha-2
`postal_code`	string \| null	CEP

ReversePayment

Campo	Tipo	Descrição
`currency`	string \| null	Código ISO 4217 da moeda
`total`	integer \| null	Valor total em centavos
`refund`	integer \| null	Valor do reembolso em centavos
`exchange`	integer \| null	Valor da troca em centavos
`reverse_payment_method`	object \| null	Método de pagamento inverso
`coupons`	array	Lista de cupons

Shipping

Campo	Tipo	Descrição
`carrier`	string \| null	Nome da transportadora
`total_value`	integer \| null	Valor do frete em centavos
`tracking_url`	string \| null	URL de rastreamento
`tracking_code`	string \| null	Código de rastreamento
`method`	string \| null	Método de envio (ex: PAC, SEDEX)
`delivery_address`	object	Endereço de entrega
`estimated_delivery_date`	integer \| null	Timestamp da data estimada de entrega
`estimated_delivery_time_in_days`	integer \| null	Tempo estimado em dias
`status`	string \| null	Status normalizado
`raw_status`	string \| null	Status original da transportadora

Delivery Address

Campo	Tipo	Descrição
`street`	string \| null	Nome da rua
`number`	string \| null	Número
`complement`	string \| null	Complemento
`neighborhood`	string \| null	Bairro
`city`	string \| null	Cidade
`state`	string \| null	Estado (sigla)
`country`	string \| null	Código ISO 3166-1 alpha-2
`postal_code`	string \| null	CEP

Status Normalizados (ShippingStatus)

Valor	Descrição
`waiting_postage`	Aguardando postagem
`waiting_tracking_code`	Aguardando código de rastreamento
`fulfilled`	Pedido separado/enviado
`in_transit`	Em trânsito
`out_for_delivery`	Saiu para entrega
`delivered`	Entregue
`withdrawal_available`	Disponível para retirada
`delayed`	Atrasado
`failed`	Falha na entrega
`not_delivered`	Não entregue
`refused`	Recusado
`returned`	Devolvido
`lost`	Extraviado
`misplaced`	Desviado
`canceled`	Cancelado
`stopped_in_inspection`	Retido em fiscalização
`in_destination_analysis`	Em análise no destino
`customs_inspection_completed`	Fiscalização aduaneira concluída
`object_destroyed`	Objeto destruído

Items

Array de produtos incluídos na devolução/troca.

Campo	Tipo	Descrição
`id`	string \| null	ID do produto
`name`	string \| null	Nome do produto
`type`	string	Tipo do produto
`quantity`	integer \| null	Quantidade
`unit_value`	integer \| null	Valor unitário em centavos
`total_value`	integer \| null	Valor total em centavos
`image_url`	string \| null	URL da imagem
`offer_type`	string	Tipo de oferta

Product Type (ProductType)

Valor	Descrição
`product`	Produto físico ou digital
`subscription_plan`	Plano de assinatura

Offer Type (OfferType)

Valor	Descrição
`main`	Oferta principal
`order_bump`	Order bump (complemento)

Observações

Timestamps são em segundos Unix (epoch)
Valores monetários são sempre em centavos