Artigos com a tag “produtos”
6 artigos
- Listar produtos Lista os produtos do produtor autenticado. Sem `status`, retorna produtos aprovados. O filtro usa `produtos.user_id` igual ao ID do produtor efetivo do token — quando o token pertence a uma subconta, sobe para o produtor pai. Esta rota é de leitura e exige `listar_produtos_api`; o cadastro (`POST /api/v1/produtos`) e a atualização (`PATCH /api/v1/produtos/{id}`) exigem a permissão separada `criar_produtos_api`. Um produto recém-cadastrado nasce pendente (`status = 0`) e por isso não aparece no filtro padrão. O estoque continua somente leitura na v1.
- Cadastrar produto Cadastra um produto para o produtor autenticado. Exige a permissão `criar_produtos_api`. O produto nasce pendente (`status = 0`), com `estoque = 0`, e é aprovado pela Paylog — que também define a configuração fiscal. `status`, `user_id`, `estoque`, `tipo_emissao`, `notazz_product_code`, `emite_nota_fiscal` e `nicho_id` são recusados com `422`, nunca ignorados. `peso_unitario` é em QUILOGRAMAS por unidade e limitado a 30; um peso enviado em gramas é recusado e nunca convertido automaticamente. A criação é idempotente por `codigo_plataforma`: um SKU já cadastrado devolve `200` com o produto inalterado.
- Consultar produto Retorna um produto somente quando ele pertence ao produtor autenticado.
- Atualizar produto Atualiza somente os campos enviados de um produto do produtor autenticado. Exige a permissão `criar_produtos_api`. Todos os campos são opcionais, mas ao menos um precisa ser enviado — um corpo vazio retorna `422`. `codigo_plataforma`, `status`, `user_id`, `estoque` e as chaves fiscais (`tipo_emissao`, `notazz_product_code`, `emite_nota_fiscal`, `nicho_id`) são imutáveis aqui e recusados com `422`. A edição de peso e dimensões é permitida mesmo em produto já aprovado: corrigir um peso enviado em gramas é um fluxo esperado. Um produto inexistente ou de outro produtor recebe a MESMA resposta `404`, sem revelar a existência.
- Criar Pedido Carrinho Crie um pedido com produtos avulsos e pacote resolvido automaticamente pela Paylog.
- Produtos Consulte, cadastre e atualize os produtos do produtor autenticado.