Parceiros

Parceiros integrados

Para fornecedores e marketplaces que querem oferecer o próprio catálogo ao agente de compras da zankh.

Todas as páginas▾

Comece aqui

Catálogo

Vendas

Inteligência artificial

Servidor MCP

Parceiros

Referência

Um parceiro é um fornecedor ou marketplace externo que sincroniza o catálogo dele com a zankh, para que o agente de compras possa oferecer os itens dele quando nenhuma loja da rede atende o pedido. É um espaço de credencial separado do de lojista: a chave começa com zk_partner_.

A rede zankh é sempre buscada primeiro; o parceiro é alternativa de prioridade 2, e cada cliente ativa cada parceiro individualmente nas configurações do agente. O prazo de entrega informado em deliveryDays é o compromisso do parceiro.

POST/v1/partnersRegistra o parceiro e devolve a chave zk_partner_....sem chave
GET/v1/partners/meIdentifica o parceiro da chave.
PUT/v1/partners/offersSincroniza o catálogo (upsert por SKU, até 500 ofertas por chamada).

Registrar

curl -X POST https://api.zankhapi.com.br/v1/partners \
  -H 'Content-Type: application/json' \
  -d '{ "name": "Meu Distribuidor", "slug": "meu-distribuidor", "contactEmail": "[email protected]" }'

O cadastro é self-service, sem aprovação prévia. 201 devolve o parceiro e a chave — exibida uma vez. 409 slug_in_use quando o slug já existe.

Sincronizar ofertas

curl -X PUT https://api.zankhapi.com.br/v1/partners/offers \
  -H "Authorization: Bearer zk_partner_..." \
  -H 'Content-Type: application/json' \
  -d '{
    "offers": [{
      "sku": "MLB-123",
      "title": "Overgrip Head Prime x3",
      "priceCents": 4490,
      "url": "https://exemplo.com/produto/MLB-123",
      "stockQuantity": 12,
      "deliveryDays": 3
    }]
  }'

Upsert por (parceiro, sku) — idempotente. Chame sempre que preço ou estoque mudarem.
Máximo de 500 ofertas por chamada.
isActive: false (ou stockQuantity: 0) esconde a oferta do agente sem apagá-la.