Inventário
Consulte o stock e aplique ajustes, limites de venda e reservas manuais controlados.
Operações
Listar · Stock — InventárioVisualize estoque de produtos, armazéns e localizações internas.
GET
Criar · Ajuste de stock — InventárioAltere as quantidades físicas e vendáveis dos produtos.
POST
Obter · Stock — InventárioVisualize estoque de produtos, armazéns e localizações internas.
GET
Atualizar · Stock — InventárioAltere as quantidades físicas e vendáveis dos produtos.
PATCH
Atualizar · Reserva manual — InventárioAlterar reservas manuais. Para operações de integrações externas.
PATCH
Atualizar · Limite de vendas — InventárioAlterar limites de venda. Para operações de integrações externas.
PATCH
Criar uma importaçãoPrepare um rascunho com até 1000 códigos ou 100 ficheiros. Isso ainda não aumenta o stock à venda.
POST
Cancelar uma importaçãoDescarte um rascunho incompleto. A operação não retira uma entrega já confirmada.
DELETE
Consultar uma importaçãoConfira o estado, a versão e a validação. O rascunho pertence à chave API que o criou.
GET
Confirmar uma entregaCrie uma entrega planeada ou recebida com o lote validado. Uma entrega planeada ainda não pode ser vendida.
POST
Receber uma entrega planeadaReceba as unidades existentes sem importar novamente os códigos ou ficheiros.
POST
Validar uma importaçãoValide o lote inteiro. Duplicatas ou entradas inválidas rejeitam o lote; os códigos nunca são truncados.
POST
Retirar uma entregaRetire somente unidades livres. As reservadas e atribuídas continuam vinculadas aos encomendas.
POST
Consultar o stock digitalLeia as configurações e quantidades antes de alterá-las. A resposta não contém códigos nem ficheiros.
GET
Configurar o stock digitalAtive códigos ou ficheiros individuais a partir do Professional. Desativar mantém o acesso às compras anteriores.
PATCH
Listar unidadesConsulte até 100 unidades por página. A lista mostra metadados sem revelar os códigos.
GET
Mudar a ordem de atribuiçãoEnvie a página completa sem filtros na ordem desejada. Uma versão desatualizada devolve 409.
POST
Ler uma unidade livreCódigos são devolvedos em JSON; ficheiros, em binário. Toda requisição exige Bearer e a permissão reveal.
GET
Verificar acesso a uma unidade livreVerifique as mesmas permissões de GET sem transferir conteúdo. A unidade não fica reservada.
HEAD
Excluir uma unidade livreRetire um código ou ficheiro não vendido e informe o motivo. Unidades reservadas ou atribuídas são recusadas.
POST
Substituir uma unidade livreTroque o código ou ficheiro sem mudar sua posição. A alteração fica no histórico do stock.
POST
Preparar um envio privadoReserve espaço para um ficheiro e vincule-o a uma importação ou à unidade que será substituída.
POST
Verificar um envioConfira tamanho, checksum e formato. Um envio pronto ainda não significa uma entrega recebida.
GET
Enviar um ficheiroEnvie o ficheiro em multipart/form-data por HTTPS. Não envie Base64 nem uma URL para buscar.
PUT
Como funciona
Os registos de stock distinguem a quantidade física on_hand, as reservas de pedidos, as reservas manuais e a quantidade disponível para venda. Use o identificador e a versão de stock retornados; stocks de produtos e variantes são destinos separados.
Um sellable_limit de -1 significa ilimitado, enquanto 0 significa indisponibilidade para venda. A disponibilidade ilimitada é representada por null em available. Não interprete null como zero. Ajustes de stock, limites de venda e reservas manuais usam operações e permissões separadas.