Cadastrar produto

POST /api/v1/produtos

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.

POST Requisição

bash

curl -X POST "https://ev.paylog.cash/api/v1/produtos" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "string",
    "codigo_plataforma": "string",
    "tipo_produto": 1,
    "peso_unitario": 0,
    "comprimento": 0,
    "largura": 0,
    "altura": 0,
    "gtin": "string",
    "ean": "string",
    "product_barcode": "string",
    "site_oficial": "https://example.com"
  }'

php

use Illuminate\Support\Facades\Http;

$response = Http::withToken('YOUR_TOKEN')
    ->acceptJson()
    ->post('https://ev.paylog.cash/api/v1/produtos', [
    'nome' => 'string',
    'codigo_plataforma' => 'string',
    'tipo_produto' => 1,
    'peso_unitario' => 0,
    'comprimento' => 0,
    'largura' => 0,
    'altura' => 0,
    'gtin' => 'string',
    'ean' => 'string',
    'product_barcode' => 'string',
    'site_oficial' => 'https://example.com'
  ]);

javascript

const response = await fetch("https://ev.paylog.cash/api/v1/produtos", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "nome": "string",
    "codigo_plataforma": "string",
    "tipo_produto": 1,
    "peso_unitario": 0,
    "comprimento": 0,
    "largura": 0,
    "altura": 0,
    "gtin": "string",
    "ean": "string",
    "product_barcode": "string",
    "site_oficial": "https://example.com"
  }),
});

python

import requests

response = requests.post(
    "https://ev.paylog.cash/api/v1/produtos",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
    "nome": "string",
    "codigo_plataforma": "string",
    "tipo_produto": 1,
    "peso_unitario": 0,
    "comprimento": 0,
    "largura": 0,
    "altura": 0,
    "gtin": "string",
    "ean": "string",
    "product_barcode": "string",
    "site_oficial": "https://example.com"
  },
)

ruby

require "net/http"
require "json"
require "uri"

uri = URI("https://ev.paylog.cash/api/v1/produtos")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_TOKEN"
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = {
  "nome" => "string",
  "codigo_plataforma" => "string",
  "tipo_produto" => 1,
  "peso_unitario" => 0,
  "comprimento" => 0,
  "largura" => 0,
  "altura" => 0,
  "gtin" => "string",
  "ean" => "string",
  "product_barcode" => "string",
  "site_oficial" => "https://example.com"
}.to_json

response = http.request(request)

201 Resposta

json

{
  "code": 200,
  "message": "string",
  "produto": {
    "id": 0,
    "nome": "string",
    "codigo_plataforma": "string",
    "tipo_produto": 1,
    "peso_unitario": 0,
    "comprimento": 0,
    "largura": 0,
    "altura": 0,
    "gtin": "string",
    "ean": "string",
    "product_barcode": "string",
    "site_oficial": "string",
    "status": 0,
    "status_label": "Pendente",
    "created_at": "2024-01-01T00:00:00Z"
  }
}

Corpo da requisição

application/json

object

Cadastro de produto. Chaves fora desta lista são RECUSADAS com 422, nunca ignoradas — status, user_id, estoque, tipo_emissao, notazz_product_code, emite_nota_fiscal e nicho_id são definidos pela Paylog.

nome string Obrigatório

Obrigatório. Nome do produto.
codigo_plataforma string Obrigatório

Obrigatório. SKU do produto; único por produtor. Reenviar um SKU existente devolve 200 com o produto inalterado.
tipo_produto integer Obrigatório

Obrigatório. 1 Encapsulado, 2 Cosmético, 3 Roupa, 5 Livro, 6 Acessórios, 7 Chá, 8 Líquido, 9 Outros, 10 Goma, 11 Brindes, 12 Suplemento em Pó. O código 4 não existe.

Valores permitidos 1 2 3 5 6 7 8 9 10 11 12
peso_unitario number Obrigatório

Obrigatório. Peso de UMA unidade em QUILOGRAMAS, de 0.001 a 30. Um item de 250 g é 0.25, nunca 250. Peso em gramas é recusado com 422 e nunca convertido: acima do teto os Correios não devolvem a cotação e o pedido trava em Correção com a mensagem enganosa Sem resposta da API.
comprimento number Obrigatório

Obrigatório. Comprimento da embalagem em centímetros.
largura number Obrigatório

Obrigatório. Largura da embalagem em centímetros.
altura number Obrigatório

Obrigatório. Altura da embalagem em centímetros.
gtin string aceita nulo

Opcional. GTIN do produto.
ean string aceita nulo

Opcional. EAN do produto.
product_barcode string aceita nulo

Opcional. Código de barras usado na operação da integração.
site_oficial string uri aceita nulo

Opcional. URL válida da página do produto.

Respostas

201

Produto criado e pendente de aprovação.

application/json

object

Envelope de POST /api/v1/produtos. code é 201 na criação e 200 quando o codigo_plataforma já existia nesta conta — no segundo caso produto vem inalterado.

code integer Obrigatório

Código HTTP repetido no corpo.

Valores permitidos 200 201
message string Obrigatório
produto object Obrigatório
Produto devolvido por POST /api/v1/produtos e PATCH /api/v1/produtos/{id}, dentro da chave produto. Não inclui estoque, preço nem campos fiscais.
- id integer Obrigatório
  
  ID interno do produto.
- nome string Obrigatório
  
  Nome do produto.
- codigo_plataforma string Obrigatório
  
  SKU do produto, único por produtor.
- tipo_produto integer Obrigatório
  
  Código do tipo do produto.
  
  Valores permitidos 1 2 3 5 6 7 8 9 10 11 12
- peso_unitario number Obrigatório
  
  Peso de uma unidade em quilogramas.
- comprimento number Obrigatório
  
  Comprimento da embalagem em centímetros.
- largura number Obrigatório
  
  Largura da embalagem em centímetros.
- altura number Obrigatório
  
  Altura da embalagem em centímetros.
- gtin string aceita nulo Obrigatório
  
  GTIN quando informado.
- ean string aceita nulo Obrigatório
  
  EAN quando informado.
- product_barcode string aceita nulo Obrigatório
  
  Código de barras interno quando informado.
- site_oficial string aceita nulo Obrigatório
  
  URL da página do produto quando informada.
- status integer Obrigatório
  
  0 pendente, 1 aprovado ou 2 desabilitado. Definido pela Paylog.
  
  Valores permitidos 0 1 2
- status_label string Obrigatório
  
  Rótulo legível do status.
  
  Valores permitidos Pendente Aprovado Desabilitado
- created_at string date-time Obrigatório
  
  Data e hora da criação, em ISO 8601.

200

Já existia um produto com o mesmo codigo_plataforma nesta conta. O produto é devolvido INALTERADO — nenhum campo do corpo é aplicado. Use PATCH /api/v1/produtos/{id} para editar.

application/json

object

Envelope de POST /api/v1/produtos. code é 201 na criação e 200 quando o codigo_plataforma já existia nesta conta — no segundo caso produto vem inalterado.

code integer Obrigatório

Código HTTP repetido no corpo.

Valores permitidos 200 201
message string Obrigatório
produto object Obrigatório
Produto devolvido por POST /api/v1/produtos e PATCH /api/v1/produtos/{id}, dentro da chave produto. Não inclui estoque, preço nem campos fiscais.
- id integer Obrigatório
  
  ID interno do produto.
- nome string Obrigatório
  
  Nome do produto.
- codigo_plataforma string Obrigatório
  
  SKU do produto, único por produtor.
- tipo_produto integer Obrigatório
  
  Código do tipo do produto.
  
  Valores permitidos 1 2 3 5 6 7 8 9 10 11 12
- peso_unitario number Obrigatório
  
  Peso de uma unidade em quilogramas.
- comprimento number Obrigatório
  
  Comprimento da embalagem em centímetros.
- largura number Obrigatório
  
  Largura da embalagem em centímetros.
- altura number Obrigatório
  
  Altura da embalagem em centímetros.
- gtin string aceita nulo Obrigatório
  
  GTIN quando informado.
- ean string aceita nulo Obrigatório
  
  EAN quando informado.
- product_barcode string aceita nulo Obrigatório
  
  Código de barras interno quando informado.
- site_oficial string aceita nulo Obrigatório
  
  URL da página do produto quando informada.
- status integer Obrigatório
  
  0 pendente, 1 aprovado ou 2 desabilitado. Definido pela Paylog.
  
  Valores permitidos 0 1 2
- status_label string Obrigatório
  
  Rótulo legível do status.
  
  Valores permitidos Pendente Aprovado Desabilitado
- created_at string date-time Obrigatório
  
  Data e hora da criação, em ISO 8601.

401

Token Bearer ausente ou inválido.

application/json

object

Mensagem de erro ou informação. Alguns erros legados omitem code.

code integer

Código numérico quando fornecido pelo endpoint.
message string

Mensagem legível.

403

Duas causas distintas com o mesmo status. Token sem a permissão criar_produtos_api usa o envelope do tratador global (errors + code). Token válido e com a permissão, mas de uma conta que não é um produtor ativo, usa o envelope da FormRequest (message).

application/json

mixed

Uma das opções

object

Envelope produzido pelo tratador global de exceções para falhas HTTP que não são geradas pelos controladores — principalmente 403 (permissão ausente) e 405 (verbo não suportado). Difere dos erros dos controladores por usar errors no lugar de message.

errors string Obrigatório

Mensagem da exceção HTTP.
code integer Obrigatório

Código HTTP repetido no corpo.

object

Mensagem de erro ou informação. Alguns erros legados omitem code.

code integer

Código numérico quando fornecido pelo endpoint.
message string

Mensagem legível.

422

Campo obrigatório ausente, valor fora das faixas, tipo_produto inexistente, chave recusada (status, user_id, estoque ou chave fiscal) ou corpo vazio no PATCH — neste último caso o erro vem na chave produto, não em um campo.

application/json

object

code integer

Código legado do erro, normalmente 400.
message string Obrigatório

Resumo do erro de validação.
erros object

Erros por campo retornados pelos endpoints legados.
errors object

Erros por campo retornados por validadores no formato atual.

500

Falha inesperada ao cadastrar o produto.

application/json

object

Mensagem de erro ou informação. Alguns erros legados omitem code.

code integer

Código numérico quando fornecido pelo endpoint.
message string

Mensagem legível.