API de Parceiros

Integre seu sistema ao SimplesFika

Mantenha o catalogo e o estoque da loja parceira sempre atualizados: cadastre produtos, ajuste precos e controle estoque pela nossa API - de forma simples e segura.

Como funciona

Voce mantem o catalogo da loja parceira no SimplesFika a partir do seu proprio sistema. E uma integracao em 3 passos:

Voce recebe uma chave. Cada loja tem uma chave de parceiro propria, que a nossa equipe gera e entrega pra voce.
Voce chama a API. Cadastra, atualiza, controla estoque e desativa produtos com requisicoes HTTP simples (JSON).
A loja reflete. Preco, estoque e SKU dos produtos que voce gerencia passam a ser controlados por voce; o lojista mantem fotos, descricao e SEO.

Autenticacao

Toda requisicao usa o cabecalho X-Partner-Key com a chave da loja. Uma chave por loja; pra obter a sua, fale com a gente (secao Suporte). As respostas seguem o formato:

{ "ok": true, "data": { ... } }

{ "ok": false, "error": "Mensagem legivel", "code": "CODIGO_ESTAVEL" }

Exemplo de requisicao

curl -X PATCH https://<dominio-da-loja>/api/partner/v1/products/CAMISA-AZUL-M/stock/ \
  -H "X-Partner-Key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"estoque": 7}'

Referencia da API

Base: https://<dominio-da-loja>/api/partner/v1/. O produto e identificado pelo SKU. O v1 cobre produtos simples (1 SKU = 1 produto).

GET /api/partner/v1/products/

Lista os produtos que voce gerencia (para reconciliacao). Escopo catalog:read.

POST /api/partner/v1/products/

Cria um produto. Retorna 409 se o SKU ja existe. Escopo catalog:write.

curl -X POST https://<dominio-da-loja>/api/partner/v1/products/ \
  -H "X-Partner-Key: SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{"sku": "CAMISA-AZUL-M", "nome": "Camisa Azul M", "preco": "79.90", "estoque": 12}'

PUT /api/partner/v1/products/{sku}/

Cria ou atualiza por SKU (idempotente). Atualiza preco/estoque; o nome so e definido na criacao. Escopo catalog:write.

PATCH /api/partner/v1/products/{sku}/stock/

Atualiza somente o estoque (valor absoluto). Escopo stock:write.

DELETE /api/partner/v1/products/{sku}/

Desativa o produto (some da vitrine, preserva o historico). Escopo catalog:write.

Erros

Erros vem com um code estavel, para o seu sistema tratar de forma programatica:

HTTP	code	Quando acontece
401	`MISSING_PARTNER_KEY`	Cabecalho X-Partner-Key ausente
403	`INVALID_PARTNER_KEY`	Chave invalida ou inativa
403	`INSUFFICIENT_SCOPE`	Chave sem permissao para a operacao
404	`PRODUCT_NOT_FOUND`	SKU nao existe (em PATCH/DELETE)
409	`SKU_ALREADY_EXISTS`	POST com um SKU que ja existe
409	`PROMOTIONAL_PRICE_ACTIVE`	Produto com promocao ativa (desative antes de mudar o preco)
409	`EXTERNAL_SOURCE_CONFLICT`	Produto ja gerenciado por outra integracao
409	`VARIANT_STOCK_NOT_SUPPORTED`	Produto com grade/variacao (nao suportado no v1)
409	`PRODUCT_MODE_NOT_SUPPORTED`	Produto do tipo kit, link externo ou encomenda
422	`VALIDATION_ERROR`	Payload invalido (ex.: estoque nao numerico)
429	`RATE_LIMITED`	Excedeu o limite de requisicoes

Suporte e parceria

Quer integrar seu sistema ao SimplesFika ou precisa da sua chave de parceiro? Fale com a nossa equipe.

Fale com a gente

Emitimos a chave de parceiro por loja e ajudamos na integracao.

[email protected] (83) 99676-0205