Alteração da situação cadastral do Produtor

Descrição: Informações atualizadas da situação cadastral de um Produtor quando aprovado dentro da plataforma Merx. Este payload é enviado pelo servidor Merx ao endpoint cadastrado no webhook quando a situação cadastral de um produtor é alterada.

Payload Recebido

Payload recebido pelo seu servidor

{
  "id": "8846b788-1438-40c8-84c3-28389063e6b8",
  "name": "Matheus Validação teste",
  "social_identity": "71223530280",
  "status": "PENDING_APPROVAL",
  "farms": [
    {
      "id": "b712c095-3060-4a29-b22d-fa6fc47dc5b6",
      "name": "INPE - PRODES CAATINGA",
      "own": false,
      "car": "BA-2906006-2EDE19AC3BFC4E0F8DC32A9ACB913ABE",
      "esg_status": "NAO_CONFORME",
      "production": [
        {
          "harvest_name": "2023 - Safrinha",
          "product_name": "Milho",
          "estimated_balance": 0.0
        },
        {
          "harvest_name": "2022/2023",
          "product_name": "Soja",
          "estimated_balance": 0.0
        },
        {
          "harvest_name": "2021/2022",
          "product_name": "Soja",
          "estimated_balance": 0.0
        }
      ]
    }
  ],
  "production": [
    {
      "harvest_id": "e5f303a3-d0e6-4ebc-92a5-d02bdccb47dc",
      "harvest_name": "2023/2024",
      "product_id": "3281a9df-8312-4483-968b-479e793ef960",
      "product_name": "Soja",
      "estimated_balance": 94744.44,
      "allocated_balance": 1680.317,
      "available_balance": 93064.123
    }
  ]
}

Campos do Payload

Campo	Tipo	Descrição
id	UUID	Identificador do produtor
name	String	Nome do produtor
social_identity	String	CPF ou CNPJ do produtor
status	String	Situação cadastral atual do produtor
farms	Array	Lista de fazendas associadas ao produtor
production	Array	Lista de produções consolidadas do produtor

As chaves nulas não são entregues. O corpo é reserializado antes de sair e campos sem valor são omitidos, inclusive dentro de objetos aninhados e de itens de lista. Campo ausente significa "sem valor": não exija a presença de chave opcional no seu parser.

Entrega

Este payload chega ao seu endpoint com os headers Content-Type: application/json, app-hash (identificador da cooperativa), event-type (o tipo do evento), Content-Hmac (assinatura sempre enviada, que não serve para validar a entrega — ver o Guia: Webhooks) e, se basic_authentication estiver configurado no webhook, Authorization: Basic <base64>.

O endpoint precisa responder 2xx em menos de 5 segundos. Responder 5xx devolve a mensagem à fila; responder 4xx encerra a entrega. Ver Guia: Webhooks — Requisitos do endpoint receptor.