curl -X POST https://{loja}.com.br/api/hunter/v1/pedidos/PED-000123/processado \
  -H "Content-Type: application/json" \
  -H "X-API-Key: hk_..." \
  -d '{
    "nota_fiscal": {
      "numero": "000000123",
      "serie": "1",
      "chave_acesso": "35240712345678000199550010000001231234567890",
      "data_emissao": "2026-07-13T10:15:00Z",
      "url_danfe": "https://storage.exemplo.com/danfe/xyz.pdf"
    }
  }'

const res = await fetch(
  `${BASE_URL}/pedidos/${codigo}/processado`,
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": process.env.API_KEY,
    },
    body: JSON.stringify({
      nota_fiscal: {
        numero: nfe.numero,
        serie: nfe.serie,
        chave_acesso: nfe.chave,
        data_emissao: nfe.emitidaEm.toISOString(),
        url_danfe: nfe.pdfUrl,
      },
    }),
  }
);

{
  "success": true,
  "data": {
    "pedido": {
      "codigo": "PED-000123",
      "status": "em_separacao",
      "processado_em": "2026-07-13T10:15:03Z"
    },
    "nota_fiscal": {
      "id": "b9810ec1-7920-4c33-a7f7-9d5ffa66f1e0",
      "numero": "000000123",
      "serie": "1"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Pedido com código 'PED-INEXISTENTE' não encontrado."
  }
}

{
  "success": false,
  "error": {
    "code": "CONFLICT",
    "message": "Pedido 'PED-000123' já processado pelo sistema integrado em 2026-07-13 10:15:03+00."
  }
}

{
  "success": false,
  "error": {
    "code": "CONFLICT",
    "message": "Pedido 'PED-000123' está em status 'cancelado' — não pode ser processado (esperado: pagamento_aprovado)."
  }
}

{
  "success": false,
  "error": {
    "code": "CONFLICT",
    "message": "Chave de acesso '35240712345678000199550010000001231234567890' já registrada em outro pedido."
  }
}