--- title: "Insere um novo pedido" method: POST path: "/pedidos" --- # Insere um novo pedido `POST /pedidos` Caso a loja utilize as formas de pagamento do gateway o campo "formaPagamentoId" do objeto "pagamento" deverá conter o valor "200". ## Request body - object - `pedidoId` integer — Id do pedido que está sendo inserido. Caso seja informado deve ser um Id disponível na loja. Caso não seja informado, um Id será gerado (optional) - `carrinhoId` string — Id do carrinho que foi utilizado no pedido (optional) - `situacaoPedidoId` integer, required — Define em qual situação está o pedido. A lista completa das possíveis situações se encontra no GET /situacoesPedido - `data` string, date, required — Data em que o pedido foi realizado - `valorTotal` number, double, required — Valor total do pedido. Se informado deve ser igual a soma de todos os valores inclusos no pedido (preços dos produtos, ajustes, frete, etc) (optional) - `valorJuros` number, double, required — Informação do juros do pedido - `valorDesconto` number, double, required — Informação de desconto do pedido - `usuarioId` integer — Id do usuário que realizou a compra. É possível recuperar o Id de um usuário no GET /usuarios - `enderecoId` integer — Id do endereço do usuário que deve ser utilizado como endereço de entrega. Para buscar os endereços de um usuário utilize o GET /usuarios/{usuarioId}/enderecos - `isMobile` boolean, required — Define se o pedido foi feito através de um dispositivo móvel ou não - `eventoId` integer — Id do evento ao qual o pedido está vinculado (opcional) - `produtos` object[] — Lista contendo os produtos do pedido - `produtoVarianteId` integer, required — Id do produto variante que está vinculado a esse pedido. - `sku` string — SKU do produto variante - `quantidade` object — Define a quantidade do produto, podendo ser dividida por diferentes centros de distribuição - `quantidadeTotal` integer, required — Quantidade por centro de distribuição - `quantidadePorCentroDeDistribuicao` object[] — Quantidade (optional) - `centroDistribuicaoId` integer — Id do centro de distribuição - `quantidade` integer — Quantidade - `precoVenda` number, double, required — Preço de venda do produto, sem adição ou subtração de valores. - `isBrinde` boolean, required — Define se esse produto é um brinde ou não - `ajustes` object[] — Lista contendo todos os ajustes de preço do produto - `tipo` string — Define o tipo do ajuste de valor de um produto contido em um pedido. = ['Frete', 'Pricing', 'Atacarejo', 'Personalizacao', 'Embalagem', 'Promocao', 'PromocaoFrete', 'ContaCorrente', 'FormaPagamento', 'PromocaoProduto', 'TipoFreteProduto', 'Formula']stringEnum:"Frete", "Pricing", "Atacarejo", "Personalizacao", "Embalagem", "Promocao", "PromocaoFrete", "ContaCorrente", "FormaPagamento", "PromocaoProduto", "TipoFreteProduto", "Formula" - `valor` number, double — Define o valor do ajuste a ser aplicado no produto. O valor pode ser positivo ou negativo - `observacao` string — Observação (optional) - `nome` string — Nome (optional) - `fretes` object[] — Informações de frete do pedido - `centroDistribuicaoId` integer, required — Identificador do centro de distribuição de origem - `freteContratoId` integer, required — Identificador do contrato de frete (optional) - `peso` number, double — Peso em gramas (g) do frete calculado (optional) - `pesoCobrado` number, double — Peso em gramas cobrado do cliente (optional) - `volume` number, double — Volume em metro cúbico (m³) calculado (optional) - `volumeCobrado` number, double — Volume em metro cúbico (m³) cobrado do cliente (optional) - `prazoEnvio` integer, required — Prazo do envio do frete em dias úteis - `valorFreteEmpresa` number, double — Valor do frete (optional) - `valorFreteCliente` number, double, required — Valor do frete cobrado do cliente - `dataEntrega` string, date — Data estimada da entrega do produto (optional) - `informacoesAdicionais` object[] — Informações adicionais do frete - `chave` string — Chave - `valor` string — Valor - `retiradaAgendada ` object[] — Dados de nome e documento para retirada na loja - `Nome` string — Nome do responsável - `Documento` string — Documento do responsável - `pagamento` object — Informações de pagamento do pedido - `formaPagamentoId` integer, required — Id da forma de pagamento - `numeroParcelas` integer, required — Número parcelas - `valorParcela` number, double, required — Valor da parcela - `informacaoAdicional` object[] — Informações adicionais de pagamento (optional) - `chave` string — Chave - `valor` string — Valor - `canalId` integer — ParceiroId vinculado ao pedido (optional) - `omniChannel` object — Dados do pedido no marketplace (optional) - `pedidoIdPublico` string — Id do pedido que o cliente vê no momento que fecha a compra - `pedidoIdPrivado` string — Id interno do marketplace - `integrador` object — Dados do pedido no integrador - `nome` string — Nome do parceiro integrador - `pedidoId` string — Numero do pedido dentro do integrador - `pedidoUrl` string — Url do pedido dentro painel do integrador - `transacaoId` integer — Id da transação (optional) - `observacao` string — Observação do pedido (optional) - `valido` boolean — Se um pedido é valido (optional) - `cupomDesconto` string — Cupom de desconto (optional) - `ip` string — IP da criação do pedido (optional) - `usuarioMaster` integer — ID do usuário master que realizou o pedido, se houver (optional) - `metadados` object[] — Lista contendo todos os metadados do pedido (optional) - `chave` string — Chave do metadado - `valor` string — Valor do metadado - `retiradaLojaId` integer — Id da loja física na qual o pedido será retirado (optional) - `usuario` object — Permite criar um novo usuário no momento da criação do pedido. Obrigatório caso não passe usuarioID - `tipoPessoa` string, required — Fisica ou Juridica - `origemContato` string — Origem do contato (ex: "Google", "Instagram") - `tipoSexo` string — Pode ser "Masculino", "Feminino" ou "Undefined" - `nome` string, required — Nome completo do usuário - `cpf` string — Obrigatório se pessoa física - `email` string, required — E-mail do usuário - `rg` string — Documento de identidade - `telefoneResidencial` string — Telefone fixo com DDD - `telefoneCelular` string — Número de celular com DDD - `telefoneComercial` string — Telefone comercial - `dataNascimento` string — Data de nascimento no formato ISO 8601 (YYYY-MM-DDTHH:mm:ssZ) - `cnpj` string — Obrigatório se pessoa jurídica - `inscricaoEstadual` string — Inscrição estadual da empresa - `responsavel` string — Nome do responsável pela empresa - `dataCriacao` string — Data de criação do cadastro (geralmente preenchida automaticamente) - `dataAtualizacao` string — Última data de atualização do cadastro - `revendedor` boolean — Indica se o usuário é revendedor (true ou false) - `avatar` string — URL da imagem de perfil - `listaInformacaoCadastral` object[] — Lista de informações adicionais ([{ chave, valor }]) - `chave` string - `valor` string - `endereco` object — Permite criar um novo endereço no momento da criação do pedido. Obrigatório caso não passe enderecoID - `nomeEndereco` string, required — Nome de referência do endereço (ex: "Residencial", "Comercial") - `rua` string, required — Nome da rua ou logradouro - `numero` string, required — Número do imóvel - `complemento` string — Complemento (ex: "Apto 101", "Bloco B") - `referencia` string — Ponto de referência - `bairro` string, required — Bairro - `cidade` string, required — cidade - `estado` string, required — Estado em sigla (ex: "SP", "RJ") - `cep` string, required — CEP no formato numérico (ex: "01001000") - `pais` string, required — País (ex: "Brasil") - `retiradaAgendada` object — Dados de nome e documento para retirada na loja - `nome` string - `documento` string ## Response `201` 201 ## Other responses - `422` — 422 - `500` — 500 --- [API](https://skmtc.net/fbits/apis/wake-commerce-api.md) · [All operations](https://skmtc.net/fbits/apis/wake-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fbits/wake-commerce-api/revisions/e07940bf249d/schema)