Produtos
O catálogo do que se cobra, item a item, antes de virar plano ou item de fatura. Publicar, arquivar e restaurar controlam a visibilidade sem destruir histórico.
| Comando | HTTP | Descrição |
|---|---|---|
products list | GET /v1/products | Listar produtos |
products create | POST /v1/products | Criar produto |
products get | GET /v1/products/{id} | Obter produto |
products update | PATCH /v1/products/{id} | Atualizar produto |
products delete | DELETE /v1/products/{id} | Arquivar produto (soft delete) |
products archive | POST /v1/products/{id}/archive | Arquivar produto |
products publish | POST /v1/products/{id}/publish | Publicar produto |
products restore | POST /v1/products/{id}/restore | Restaurar produto arquivado |
products bulk-archive create | POST /v1/products/bulk-archive | Arquivar produtos em lote |
products bulk-change-company create | POST /v1/products/bulk-change-company | Trocar empresa de produtos em lote |
products bulk-delete create | POST /v1/products/bulk-delete | Excluir produtos em lote |
products bulk-move-group create | POST /v1/products/bulk-move-group | Mover produtos para outro grupo |
products bulk-visibility create | POST /v1/products/bulk-visibility | Alterar visibilidade em lote |
products reorder create | POST /v1/products/reorder | Reordenar produtos |
products reorder update | PUT /v1/products/reorder | Reordenar produtos (PUT /reorder) |
Exemplos
--params carrega parâmetros de query e de caminho (id, página, filtros); --json carrega o corpo da requisição; --fields limita os campos que voltam — vale a pena em todo list/get, para economizar contexto. Veja Flags globais para a referência completa.
# Listar produtos
kobana billing products list \
--fields "id,public_id,external_id,organization_id,company_id"
# Obter produto
kobana billing products get --params '{"id": "PRODUCT_ID"}'
# Criar produto
kobana billing products create --json '{"name": "NAME", "slug": "SLUG"}'
# Atualizar produto
kobana billing products update \
--params '{"id": "PRODUCT_ID"}' \
--json '{"name": "NAME", "slug": "SLUG", "description": "DESCRIPTION"}'
# Arquivar produto
kobana billing products archive --params '{"id": "PRODUCT_ID"}'
# Arquivar produto (soft delete)
kobana billing products delete --params '{"id": "PRODUCT_ID"}' --dry-run
Próximos passos
- Grupos de produtos
- Introspecção de schema — todos os parâmetros que este recurso aceita.