Criar pedido carrinho

POST /api/v1/pedidos/carrinho

Cria um pedido a partir de produtos avulsos do produtor autenticado, sem exigir um pacote previamente cadastrado. A Paylog calcula valor_venda pela soma de quantidade × valor_unitario e reutiliza ou cria um pacote normal com a composição enviada. Sem frete_selecionado, o pedido segue o leilão de frete configurado na conta. Quando a opção é enviada, seus códigos devem vir de POST /api/v1/frete/calcular e a cotação é refeita no servidor antes de ser persistida.

POST Requisição

bash

curl -X POST "https://ev.paylog.cash/api/v1/pedidos/carrinho" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "cliente_id": 0,
    "referencia_externa": "string",
    "faturar": true,
    "itens": [
      {
        "produto_id": 0,
        "quantidade": 0,
        "valor_unitario": 0
      }
    ],
    "frete_selecionado": {
      "transportadora_codigo": "string",
      "servico_codigo": "string"
    },
    "parametros_rastreamento": {
      "utm_source": "string",
      "utm_medium": "string",
      "utm_campaign": "string",
      "utm_content": "string",
      "utm_term": "string",
      "utm_id": "string",
      "src": "string",
      "sck": "string",
      "xcod": "string",
      "campaign_code": "string",
      "campaign_name": "string",
      "origin_url": "https://example.com",
      "query_params": {}
    }
  }'

php

use Illuminate\Support\Facades\Http;

$response = Http::withToken('YOUR_TOKEN')
    ->acceptJson()
    ->post('https://ev.paylog.cash/api/v1/pedidos/carrinho', [
    'cliente_id' => 0,
    'referencia_externa' => 'string',
    'faturar' => true,
    'itens' => [
      [
        'produto_id' => 0,
        'quantidade' => 0,
        'valor_unitario' => 0
      ]
    ],
    'frete_selecionado' => [
      'transportadora_codigo' => 'string',
      'servico_codigo' => 'string'
    ],
    'parametros_rastreamento' => [
      'utm_source' => 'string',
      'utm_medium' => 'string',
      'utm_campaign' => 'string',
      'utm_content' => 'string',
      'utm_term' => 'string',
      'utm_id' => 'string',
      'src' => 'string',
      'sck' => 'string',
      'xcod' => 'string',
      'campaign_code' => 'string',
      'campaign_name' => 'string',
      'origin_url' => 'https://example.com',
      'query_params' => []
    ]
  ]);

javascript

const response = await fetch("https://ev.paylog.cash/api/v1/pedidos/carrinho", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "cliente_id": 0,
    "referencia_externa": "string",
    "faturar": true,
    "itens": [
      {
        "produto_id": 0,
        "quantidade": 0,
        "valor_unitario": 0
      }
    ],
    "frete_selecionado": {
      "transportadora_codigo": "string",
      "servico_codigo": "string"
    },
    "parametros_rastreamento": {
      "utm_source": "string",
      "utm_medium": "string",
      "utm_campaign": "string",
      "utm_content": "string",
      "utm_term": "string",
      "utm_id": "string",
      "src": "string",
      "sck": "string",
      "xcod": "string",
      "campaign_code": "string",
      "campaign_name": "string",
      "origin_url": "https://example.com",
      "query_params": {}
    }
  }),
});

python

import requests

response = requests.post(
    "https://ev.paylog.cash/api/v1/pedidos/carrinho",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
    "cliente_id": 0,
    "referencia_externa": "string",
    "faturar": True,
    "itens": [
      {
        "produto_id": 0,
        "quantidade": 0,
        "valor_unitario": 0
      }
    ],
    "frete_selecionado": {
      "transportadora_codigo": "string",
      "servico_codigo": "string"
    },
    "parametros_rastreamento": {
      "utm_source": "string",
      "utm_medium": "string",
      "utm_campaign": "string",
      "utm_content": "string",
      "utm_term": "string",
      "utm_id": "string",
      "src": "string",
      "sck": "string",
      "xcod": "string",
      "campaign_code": "string",
      "campaign_name": "string",
      "origin_url": "https://example.com",
      "query_params": {}
    }
  },
)

ruby

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

uri = URI("https://ev.paylog.cash/api/v1/pedidos/carrinho")
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 = {
  "cliente_id" => 0,
  "referencia_externa" => "string",
  "faturar" => true,
  "itens" => [
    {
      "produto_id" => 0,
      "quantidade" => 0,
      "valor_unitario" => 0
    }
  ],
  "frete_selecionado" => {
    "transportadora_codigo" => "string",
    "servico_codigo" => "string"
  },
  "parametros_rastreamento" => {
    "utm_source" => "string",
    "utm_medium" => "string",
    "utm_campaign" => "string",
    "utm_content" => "string",
    "utm_term" => "string",
    "utm_id" => "string",
    "src" => "string",
    "sck" => "string",
    "xcod" => "string",
    "campaign_code" => "string",
    "campaign_name" => "string",
    "origin_url" => "https://example.com",
    "query_params" => {}
  }
}.to_json

response = http.request(request)

201 Resposta

json

{
  "code": 0,
  "message": "string",
  "pedido": {
    "id": 0,
    "pacote_id": 0,
    "valor_venda": 0,
    "logistica_preselecionada": true
  }
}

Corpo da requisição

application/json

object

cliente_id integer Obrigatório

Cliente pertencente ao produtor autenticado.
referencia_externa string aceita nulo

Identificador opcional no sistema de origem.
faturar boolean

Quando true, solicita o início do fluxo de faturamento após a criação.
itens array Obrigatório
Produtos distintos usados para calcular o valor total e montar o pacote.
Itens
object

produto_id integer Obrigatório

Produto ativo, aprovado e pertencente ao produtor autenticado.

quantidade integer Obrigatório

Quantidade deste produto no pedido.

valor_unitario integer Obrigatório

Valor unitário em centavos; zero é aceito.
frete_selecionado object
Opção retornada pela calculadora de frete. A Paylog refaz a cotação e não aceita preço, prazo, custo ou margem enviados pela integração.
- transportadora_codigo string Obrigatório
  
  Código estável da transportadora retornado pela calculadora.
- servico_codigo string Obrigatório
  
  Código exato do serviço retornado pela calculadora.
parametros_rastreamento object aceita nulo
Opcional. UTMs e identificadores de campanha associados ao pedido. Todos os campos internos também são opcionais. Quando omitido, vazio ou composto somente por valores vazios, nenhum registro de rastreamento é criado.
- utm_source string aceita nulo
  
  Opcional. Origem da campanha.
- utm_medium string aceita nulo
  
  Opcional. Mídia ou canal.
- utm_campaign string aceita nulo
  
  Opcional. Nome ou código da campanha.
- utm_content string aceita nulo
  
  Opcional. Variação do conteúdo ou criativo.
- utm_term string aceita nulo
  
  Opcional. Termo associado.
- utm_id string aceita nulo
  
  Opcional. ID externo da campanha.
- src string aceita nulo
  
  Opcional. Código de origem.
- sck string aceita nulo
  
  Opcional. Código de rastreamento.
- xcod string aceita nulo
  
  Opcional. Código complementar.
- campaign_code string aceita nulo
  
  Opcional. Código externo da campanha.
- campaign_name string aceita nulo
  
  Opcional. Nome externo da campanha.
- origin_url string uri aceita nulo
  
  Opcional. URL HTTP/HTTPS de origem.
- query_params object aceita nulo
  
  Opcional. Aceita somente identificadores públicos de atribuição da lista permitida. Objetos, listas, segredos, tokens de sessão e chaves arbitrárias não são aceitos.

Respostas

201

Pedido e pacote criados ou reutilizados com sucesso.

application/json

object

code integer Obrigatório
message string Obrigatório
pedido object Obrigatório
- id integer Obrigatório
  
  ID interno do pedido criado.
- pacote_id integer Obrigatório
  
  Pacote normal reutilizado ou criado para a composição.
- valor_venda integer Obrigatório
  
  Soma dos itens em centavos.
- logistica_preselecionada boolean Obrigatório
  
  Indica se uma cotação explícita foi validada e gravada.

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

A conta autenticada não pode criar pedidos.

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.

422

Corpo inválido, cliente/produto fora da conta ou cotação não disponível.

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 interna durante o processamento.

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.