Criar cotação em rascunho

POST https://api.precificador3d.com.br/v1/cotacoes

Escopo: cotacoes:escrever (quem criou a chave precisa de cotacoes.editar). A cotação nasce em rascunho, com o preço calculado no servidor (faixa por quantidade). A API não aceita preço, desconto nem custo. Enviar ao cliente continua pelo app. Operação de escrita com custo 5.

cURL

curl -X POST "https://api.precificador3d.com.br/v1/cotacoes" \
  -H "Authorization: Bearer $PC3D_CHAVE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  --data '{
  "titulo": "Chaveiros evento Loja Exemplo",
  "cliente": {
    "nome": "Ana Lima",
    "contato": "ana.lima@example.com"
  },
  "validade": "2026-10-31",
  "observacao": "Pedido pelo formulário da loja.",
  "itens": [
    {
      "produto_id": "5a6b7c8d-9e0f-4a1b-2c3d-4e5f6a7b8c9d",
      "variacao_id": "6b7c8d9e-0f1a-4b2c-3d4e-5f6a7b8c9d0e",
      "quantidade": 200
    }
  ]
}'

JavaScript

const resposta = await fetch('https://api.precificador3d.com.br/v1/cotacoes', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PC3D_CHAVE}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "titulo": "Chaveiros evento Loja Exemplo",
    "cliente": {
      "nome": "Ana Lima",
      "contato": "ana.lima@example.com"
    },
    "validade": "2026-10-31",
    "observacao": "Pedido pelo formulário da loja.",
    "itens": [
      {
        "produto_id": "5a6b7c8d-9e0f-4a1b-2c3d-4e5f6a7b8c9d",
        "variacao_id": "6b7c8d9e-0f1a-4b2c-3d4e-5f6a7b8c9d0e",
        "quantidade": 200
      }
    ]
  }),
});
if (!resposta.ok) {
  const erro = await resposta.json(); // application/problem+json
  throw new Error(`${erro.codigo}: ${erro.detail} (${erro.requisicao_id})`);
}
const dados = await resposta.json();

Python

import os
import uuid

import requests

resposta = requests.post(
    "https://api.precificador3d.com.br/v1/cotacoes",
    headers={
        "Authorization": f"Bearer {os.environ['PC3D_CHAVE']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "titulo": "Chaveiros evento Loja Exemplo",
        "cliente": {
            "nome": "Ana Lima",
            "contato": "ana.lima@example.com",
        },
        "validade": "2026-10-31",
        "observacao": "Pedido pelo formulário da loja.",
        "itens": [
            {
                "produto_id": "5a6b7c8d-9e0f-4a1b-2c3d-4e5f6a7b8c9d",
                "variacao_id": "6b7c8d9e-0f1a-4b2c-3d4e-5f6a7b8c9d0e",
                "quantidade": 200,
            },
        ],
    },
    timeout=10,
)
resposta.raise_for_status()
dados = resposta.json()

Cabeçalhos

Idempotency-Keystringobrigatório: Chave única da operação, guardada por 24 h junto com o hash do corpo, o status e o id criado (sem corpo nem resposta). Repetir com o mesmo corpo devolve o mesmo status e o recurso relido pelo id. A mesma chave com outro corpo responde 422 idempotencia_conflito. (até 64 caracteres)

Corpo da requisição application/json

titulostringobrigatório: (até 120 caracteres)
clienteobjectobrigatório
cliente.nomestringobrigatório: (até 120 caracteres)
cliente.contatostring: (até 160 caracteres)
validadestring (date)
observacaostring: (até 1000 caracteres)
itensarray de objectobrigatório: (1 a 100 itens)
itens[].produto_idstring (uuid)obrigatório
itens[].variacao_idstring (uuid)
itens[].quantidadeintegerobrigatório: (de 1 a 99999)
itens[].cor_idstring (uuid)

Resposta 201

Cotação criada em rascunho.

Campos da resposta (36)

idstring (uuid)
codigostring
titulostring
statusstring: Valores: rascunho, enviada, aprovada, recusada, em_analise, arquivado.
versaointeger
clienteobject
cliente.nomestring | null
cliente.contatostring | null
validadestring (date) | null
condicoesstring | null
observacaostring | null
itensarray de object
itens[].idstring (uuid)
itens[].nomestring
itens[].skustring | null
itens[].produto_idstring (uuid) | null
itens[].variacao_idstring (uuid) | null
itens[].quantidadeinteger
itens[].preco_unitario_centavosinteger: (de 0 a 100000000000)
itens[].total_centavosinteger: (de 0 a 100000000000)
itens[].corCorCliente | null
itens[].cor.idstring (uuid)
itens[].cor.codigostring
itens[].cor.nome_clientestring
itens[].cor.acabamentostring: Valores: nenhum, brilhante, fosco.
itens[].cor_a_combinarboolean
total_centavosinteger: (de 0 a 100000000000)
desconto_centavosinteger: (de 0 a 100000000000)
criado_emstring (date-time)
atualizado_emstring (date-time)
enviada_emstring (date-time) | null
aprovada_emstring (date-time) | null
congeladaboolean: true fora de rascunho e em_analise. Congelada, a cotação só se edita voltando para rascunho pela tela.
custo_total_centavosinteger: [custos] (de 0 a 100000000000)
lucro_centavosinteger: [custos]
margem_bpinteger: [custos] Pontos-base.

201 Resposta

{
  "id": "9e0f1a2b-3c4d-4e5f-6a7b-8c9d0e1f2a3b",
  "codigo": "COT-0042",
  "titulo": "Chaveiros evento Loja Exemplo",
  "status": "rascunho",
  "versao": 1,
  "cliente": {
    "nome": "Ana Lima",
    "contato": "ana.lima@example.com"
  },
  "validade": "2026-10-31",
  "condicoes": "Pagamento 50% na aprovação e 50% na entrega.",
  "observacao": "Pedido pelo formulário da loja.",
  "itens": [
    {
      "id": "d3e4f5a6-b7c8-4d9e-0f1a-2b3c4d5e6f7a",
      "nome": "Chaveiro Dragão · Azul",
      "sku": "CHAV-DRG-AZ",
      "produto_id": "5a6b7c8d-9e0f-4a1b-2c3d-4e5f6a7b8c9d",
      "variacao_id": "6b7c8d9e-0f1a-4b2c-3d4e-5f6a7b8c9d0e",
      "quantidade": 200,
      "preco_unitario_centavos": 1290,
      "total_centavos": 258000,
      "cor": null,
      "cor_a_combinar": false
    }
  ],
  "total_centavos": 258000,
  "desconto_centavos": 0,
  "criado_em": "2026-10-03T14:00:00-03:00",
  "atualizado_em": "2026-10-03T14:00:00-03:00",
  "enviada_em": null,
  "aprovada_em": null
}

Outras respostas

400 dados_invalidos: Dados, filtro, cursor ou cabeçalho inválido.
401 nao_autenticado: Chave ausente, malformada, desconhecida, revogada ou expirada (a resposta é a mesma para todos os casos).
403 escopo_insuficiente: Escopo insuficiente, conta bloqueada, módulo desligado ou chave suspensa.
408 tempo_esgotado: O corpo do POST não chegou inteiro em 5 s.
409 idempotencia_em_andamento: Requisição com a mesma Idempotency-Key ainda em andamento.
413 corpo_grande_demais: Corpo acima de 64 KB.
415 tipo_nao_suportado: Só `application/json`.
422 saldo_insuficiente: Regra de negócio recusou (referência de outra conta ou inexistente, saldo insuficiente, quantidade fora do mínimo ou múltiplo) ou a Idempotency-Key já foi usada com outro corpo (`idempotencia_conflito`).
429 limite_excedido: Limite de uso excedido (rajada, minuto, mês ou requisições simultâneas).
500 erro_interno: Erro interno. O detalhe fica no log, ligado ao requisicao_id.
503 indisponivel: API desligada, sob pressão (disjuntor aberto) ou no limite global da plataforma.

Esta página em Markdown · llms.txt