Integrações

Conecte seu catálogo em horas — escale para tempo real

Do upload manual ao webhook de preço. Escolha o tier de integração conforme a maturidade do seu negócio.

Níveis de integração

Tier 1 — Manual

Upload manual e sync semanal. Ideal para começar.

Tier 2 — Automático

URL, SFTP e API batch. Atualização até 24h.

Tier 3 — Tempo real

Webhook e PRECI Network. Tempo quase real.

Métodos disponíveis

Tier 1

Upload Manual

CSV · XLSX · JSON

Importação via painel gestor com validação automática e truth layer.

Cadência: Semanal ou sob demanda

Conta gestor
Contrato SLA Tier 1 aceito

Tier 2

Sync por URL

URL pública do arquivo

Scheduler PRECIVOX busca o arquivo automaticamente no intervalo configurado.

Cadência: 6h · 12h · 24h · semanal

Tier ≥ 2
URL estável do catálogo
Unidade de destino configurada

Tier 2

Sync SFTP

SFTP seguro

Integração com servidor do parceiro para catálogos grandes.

Cadência: 6h · 12h · 24h · semanal

Tier ≥ 2
Credenciais SFTP
Contrato SLA aceito

Tier 2

API Batch

POST /api/partner/v1/estoques

Atualização programática de estoques via JSON com autenticação Bearer.

Cadência: Sob demanda (≤ 24h SLA Tier 2)

Tier ≥ 2
PARTNER_API_KEYS configurada
mercadoId + unidadeId

Tier 3

Webhook de Preço

POST /api/partner/v1/preco-alterado

Alterações incrementais de preço em tempo quase real (até 500/request).

Cadência: Tempo real

Tier 3
Chave API
eventId para idempotência

Tier 3

PRECI Network

GET /api/preci-network/v1/*

API de intenção agregada para CPG e parceiros enterprise (LGPD).

Cadência: Consulta sob demanda

Plano Enterprise
PRECI_NETWORK_API_KEYS
Contrato LGPD CPG

Schema do catálogo

Colunas aceitas no upload CSV, XLSX ou JSON (até 50 MB).

Coluna	Obrigatório	Exemplo
nome	Sim	Arroz Branco 5kg
preco	Sim	24.90
quantidade	Não	120
codigo_barras	Não	7891234567890
categoria	Não	Alimentos
marca	Não	Camil
preco_promocional	Não	21.90
em_promocao	Não	true

Referência de API

Batch de estoques (Tier 2+)

POST /api/partner/v1/estoques
Authorization: Bearer <chave-do-mercado>
Content-Type: application/json

{
  "mercadoId": "uuid-do-mercado",
  "unidadeId": "uuid-da-unidade",
  "itens": [
    {
      "nome": "Arroz Branco 5kg",
      "preco": 24.9,
      "quantidade": 120,
      "codigo_barras": "7891234567890",
      "categoria": "Alimentos",
      "marca": "Camil",
      "preco_promocional": 21.9,
      "em_promocao": true
    }
  ]
}

Webhook de preço (Tier 3)

POST /api/partner/v1/preco-alterado
Authorization: Bearer <chave>
Content-Type: application/json

{
  "mercadoId": "uuid",
  "unidadeId": "uuid",
  "eventId": "idempotencia-opcional",
  "alteracoes": [
    {
      "codigoBarras": "7891234567890",
      "preco": 22.5,
      "precoPromocional": 19.9,
      "emPromocao": true,
      "quantidade": 80
    }
  ]
}

PRECI Network — Intent (Enterprise)

GET /api/preci-network/v1/intent?mercadoId=<ID>&dias=14&regiaoModo=cep5
Authorization: Bearer <chave-cpg>

Documentação completa interna: docs/PARCEIRO_EXPORT_CATALOGO.md · Chaves API configuradas pelo time PRECIVOX após contrato.

Pronto para integrar?

Nossa equipe configura a primeira carga em menos de 24 horas.

Solicitar onboarding técnico