Histórico de Alterações

23/10/2026

Alteração: Endpoint Listar pedidos (GET /pedidos)

Adicionado o filtro de pedidos cancelados na listagem. Para usar, envie filtros[status]=cancelado.

filtros[status] agora aceita: realizado, cancelado, em_separacao, separado, despachado, entregue.

Adicionado filtros[status_pagamento] para filtrar pelo status financeiro do pedido.

20/10/2026

Alteração: Resource de listagem de pedidos

Adicionado acrescimo no pedido:

{ "acrescimo": 5.0, "desconto": 10.0, "total": 95.0 }

Atenção: acrescimo agora compõe o valor total.

19/10/2026

Alteração: Endpoint Listar produtos (GET /produtos)

search.column agora aceita todos (busca em todos os campos).

filtros[status] agora aceita: todos, ativos, desativados, sem_estoque, destaques, 0, 1.

Novos filtros: filtros[fornecedor_id], filtros[categoria_id], filtros[catalogo_id], filtros[catalogo_padrao] (true/false), filtros[outro] (com_desconto, com_compra_minima, com_compra_maxima, com_preco_personalizado_variacao, desvinculado_bling).

Nova ordenação: order_by (id, nome, preco, estoque, total_estoque, total_vendas, total_visualizacoes, created_at) + order_dir (asc, desc).

12/10/2026 — Múltiplos Depósitos

Novidade: Múltiplos Depósitos

Agora a loja pode ter vários depósitos (ex: Matriz, Loja física, CD). Cada produto tem saldo separado por depósito.

Exige plano com controle de estoque + depósitos. Sem o plano, GET /depositos retorna 403.

Novos Endpoints: Depósitos (GET /depositos)

Listar: GET /depositos (só ativos, ordenado com padrão primeiro). Busca por search.column=nome, paginação page/length (máx 100):

{ "id": 1, "nome": "Matriz", "padrao": true, "status": true, "estoque_total": 120 }

Detalhe/criar/editar/excluir: GET /depositos/{id}, POST /depositos, POST /depositos/{id}, DELETE /depositos/{id}.

Limite do plano: GET /depositos/limite (mostra total contratado, usados e disponíveis).

Vincular catálogo: POST /catalogos/{id}/deposito com { "deposito_id": 1 }. id=0 = catálogo padrão

Alteração: Produto — saldo por depósito (GET /produtos)

Adicionado estoque_por_deposito[]. Use-o para multi-depósito; estoque continua como total agregado:

"estoque_por_deposito": [
  { "deposito_id": 1, "variacao_id": 0, "quantidade": 6 },
  { "deposito_id": 2, "variacao_id": 0, "quantidade": 4 }
]

variacao_id: 0 = produto simples. Vem [] quando o produto não controla estoque, não tem saldo ou os depósitos foram excluídos.

Regras: não é possível excluir o depósito padrão, o último ativo, depósito com estoque ou vinculado a catálogos/config de marketplace. Inativar o padrão também é bloqueado.

Alteração: Pedido + Catálogo

Pedido: adicionado deposito_id (pode ser null em pedidos antigos — não trate como 0). O valor é o depósito registrado no pedido e não muda se o catálogo/depósito mudar depois.

Catálogo: adicionado deposito_id (pode ser null quando sem vínculo).

02/09/2026

Alteração: Endpoint Listar links (GET /links)

Novo filtro filtros[origem]: manual, chatbot, gerador_links.

31/08/2026

Novos Endpoints: Widgets - listar (GET /widgets)

Lista widgets com page/length e busca por nome:

{ "id": 1, "nome": "Selo frete grátis", "descricao": "<div>...</div>" }

16/07/2026

Alteração: Fiscal NFe/NFC-e e produtos

Produto fiscal: adicionados icms_situacao_tributaria_cpf/cnpj/exterior (padrão 102).

NFe/NFC-e (GET /nfe, GET /nfce): adicionados campos da Reforma Tributária v_bc_ibscbs, v_ibs_uf, v_ibs_mun, v_ibs, v_cbs, v_is, v_nf_tot (vêm null quando sem valor) e nos itens cst_ibs_cbs, c_class_trib, p_ibs_uf, v_ibs_uf, p_ibs_mun, v_ibs_mun, p_cbs, v_cbs, v_ibs.

Emitente: adicionados ibs_cbs_regime, vigencia_semestre.

10/07/2026

Alteração: Resource de pedidos - marketplace

Quando o pedido é de marketplace, retorna shopee_pedido ou tiktokshop_pedido junto ao pedido.

09/07/2026

Alteração: Resource de brindes

Adicionados controlar_estoque: true/false e estoque: 10. Bloqueie o resgate quando estoque <= 0.

29/06/2026

Alteração: Resource de cashback

Adicionado origem no cashback.

03/06/2026

Alteração: Resource de pedidos - quem editou/cancelou

editado_por agora é objeto {id, nome, ...} ou null (antes string). Ajuste a leitura.

Novo cancelado_por no mesmo formato, mostra quem cancelou.

Novo kit_selecoes com as seleções quando o produto é kit.

23/04/2026

Alteração: Resource de produtos - tipo kit

Adicionado tipo_produto: simples ou kit (padrão simples). Se kit, leia kit_selecoes no pedido.

06/03/2026

Alteração: Resource de clientes

ultima_compra agora vem formatada Y-m-d H:i:s ou null (ex: 2026-03-06 10:00:00).

19/03/2026

Alteração: Endpoint Listar templates (GET /templates_mensagens) - migração

Endpoint unificado. Filtros antigos livres de categoria/status do WABA foram substituídos por:

filtros[canal]: whatsapp_business, whatsapp_web, email, push

filtros[whatsapp_business_categoria]: marketing, utilidade, autenticacao

filtros[whatsapp_business_status]: pendente, processando, em_analise, aprovado, reprovado, pausado, erro, nao_vinculado

filtros[status]: ativo, inativo

filtros[grupo]: grupo do template (ex: finalizacao_pedido, carrinho_abandonado, campanha, kanban, avulsa)

Busca: search.column=nome

30/12/2025

Alteração: Resource de produtos - código de barras

cod_barras (produto e variações) agora sempre vem como objeto, mesmo vazio:

"cod_barras": { "tipo": "interno", "numero": null, "numero_interno": "10000005000000136" }

Não cheque if cod_barras — cheque numero.

25/11/2025

Alteração: Resource de listagem de produtos

Adicionado na listagem de produtos o código de barras interno do produto e das variações, sem afetar o código de barras externo:

"cod_barras": {
    "tipo": "ean13",
    "numero": "7891234567890", // Externo
    "numero_interno": "10000005000000136"
}

18/11/2025

Alteração: Resource de listagem de pedidos

Adicionado na listagem de produtos do pedido os dados: preço, sku do produto e sku da variação

04/08/2025

Novos Endpoints:

Grupos de Variações: listar, obter, criar, editar e excluir

Variações: listar, obter, criar, editar e excluir

Produtos: criar, editar e excluir

Catálogos: listar

Alteração: Resource de listagem de produtos

Devido o lançamento dos novos endpoints dos Produtos, houve a necessidade de alterar o Resource dos Produtos para padronizar e abranger toda a estrutura de dados dos Produtos.

15/07/2025

Alteração: Endpoint Listar pedidos (GET /pedidos):

Incluído a informação desconto_total com o somatório do desconto e desconto_sistema.

Incluído a informação taxa com o valor da taxa da forma de pagamento escolhida.

Alterado o valor de subtotal:

Antes o valor da taxa já estava incluso no subtotal, agora o valor da taxa virá separado.

Histórico de Alterações

Alteração: Endpoint Listar pedidos (GET /pedidos)#

Alteração: Resource de listagem de pedidos#

Alteração: Endpoint Listar produtos (GET /produtos)#

Novidade: Múltiplos Depósitos#

Novos Endpoints: Depósitos (GET /depositos)#

Alteração: Produto — saldo por depósito (GET /produtos)#

Alteração: Pedido + Catálogo#

Alteração: Endpoint Listar links (GET /links)#

Novos Endpoints: Widgets - listar (GET /widgets)#

Alteração: Fiscal NFe/NFC-e e produtos#

Alteração: Resource de pedidos - marketplace#

Alteração: Resource de brindes#

Alteração: Resource de cashback#

Alteração: Resource de pedidos - quem editou/cancelou#

Alteração: Resource de produtos - tipo kit#

Alteração: Resource de clientes#

Alteração: Endpoint Listar templates (GET /templates_mensagens) - migração#

Alteração: Resource de produtos - código de barras#

Alteração: Resource de listagem de produtos#

Alteração: Resource de listagem de pedidos#

Novos Endpoints:#

Alteração: Resource de listagem de produtos#

Alteração: Endpoint Listar pedidos (GET /pedidos):#

Alteração: Endpoint Listar pedidos (GET /pedidos)

Alteração: Resource de listagem de pedidos

Alteração: Endpoint Listar produtos (GET /produtos)

Novidade: Múltiplos Depósitos

Novos Endpoints: Depósitos (GET /depositos)

Alteração: Produto — saldo por depósito (GET /produtos)

Alteração: Pedido + Catálogo

Alteração: Endpoint Listar links (GET /links)

Novos Endpoints: Widgets - listar (GET /widgets)

Alteração: Fiscal NFe/NFC-e e produtos

Alteração: Resource de pedidos - marketplace

Alteração: Resource de brindes

Alteração: Resource de cashback

Alteração: Resource de pedidos - quem editou/cancelou

Alteração: Resource de produtos - tipo kit

Alteração: Resource de clientes

Alteração: Endpoint Listar templates (GET /templates_mensagens) - migração

Alteração: Resource de produtos - código de barras

Alteração: Resource de listagem de produtos

Alteração: Resource de listagem de pedidos

Novos Endpoints:

Alteração: Resource de listagem de produtos

Alteração: Endpoint Listar pedidos (GET /pedidos):