# Cria um novo pedido de venda

Cria um novo pedido de venda com status em aberto.

Endpoint: POST /api/v3/sale-orders
Version: 3.0.0
Security: OAuth2

## Header parameters:

  - `CPlug-Company-Id` (number, required)
    Id da Empresa (Company).

Você pode localizar os IDs das empresas no _endpoint_ de listagem de empresas.
    Example: 12

  - `Idempotency-Key` (string, required)
    UUID aleatório gerado por você. Nós utilizamos esse header para evitar duplicidade de registros, ou seja, caso você não tenha recebido a resposta de alguma requisição e mandar o mesmo UUID, nós não duplicaremos o registro.

## Request fields (application/json):

  - `unique_id` (string, required)
    Identificador único do pedido de venda. O UUID deve ser gerado por você.
    Example: "cf2e0a5e-aa58-4181-9c9b-47702bd2be99"

  - `items` (array, required)
    Lista de produtos deste pedido.

  - `items.item_id` (integer, required)
    Id único do item. Obrigatório na atualização.
    Example: 123

  - `items.grid_id` (integer)
    Id único do grid que este item faz parte.

O grid_id é o ID do Product Grid
    Example: 456

  - `items.amount` (number, required)
    quantidade
    Example: 5

  - `items.unitary_value` (object, required)
    Valor unitário do item

  - `items.unitary_value.amount` (number, required)
    Valor expresso como um número decimal das principais unidades monetárias
    Example: 99.95

  - `items.unitary_value.currency` (string, required)
    Código de moeda de 3 letras conforme definido pela ISO-4217
    Example: "BRL"

  - `items.total_value` (object)
    Valor total do item

  - `items.unitary_value_ipi` (object)
    Valor IPI unitário do item

  - `items.discount` (object)
    Desconto no item

  - `items.notes` (string)
    Id único do estoque
    Example: "sem chocolate"

  - `items.stock_id` (integer)
    Id único do estoque
    Example: 1234

  - `items.attributes` (array)
    Lista de atributos deste produto neste pedido.

  - `items.attributes.id` (integer)
    ID única do atributo na relação. Obrigatório na atualização.
    Example: 456

  - `items.attributes.attribute_id` (integer, required)
    ID única do atributo.
    Example: 789

  - `items.attributes.min_choices` (integer)
    número mínino que este atributo deve ter. Obrigatório quando não tiver valor no grid_id
    Example: 1

  - `items.attributes.max_choices` (integer)
    número máximo que este atributo pode ter. Obrigatório quando não tiver valor no grid_id
    Example: 2

  - `items.attributes.total_value` (object)
    Valor total deste atributo. Obrigatório quando não tiver valor no grid_id

Formula: 
  - price_calculation_type = Cumulative: total_value = sum((option.unitary_value * option.amount) - option.discount)
  - price_calculation_type = Highest: total_value = hightest(option.unitary_value)
  - price_calculation_type = Average: total_value = avg((option.unitary_value * option.amount) - option.discount)

  - `items.attributes.price_calculation_type` (any)
    Tipo de cálculo no total do atributo. Obrigatório quando não tiver valor no grid_id

Ex: average, quer dizer a o valor total do atributo será a média dos valores das opções

- Highest maior valor das opções
- Average média dos valores das opções
- Cumulative soma dos valores das opções
    Enum: "Highest", "Average", "Cumulative"

  - `items.attributes.charge_from_quantity` (integer)
    Indica a partir de qual opção irá começar a cobrar. Obrigatório quando não tiver valor no grid_id.

Ex: 3, indica se a partir da terceira opção que irá fazer parte do cálculo do total do atributo. 
Portanto, a primeira e a segunda opção será de graça, ou seja, essas duas opções deverão estar 
com o desconto igual ao valor total da opção.
    Example: 2

  - `items.attributes.options` (array, required)
    Lista de opções de um atributo.

  - `items.attributes.options.id` (integer)
    Id único da opção na relação. Obrigatório na atualização.
    Example: 123

  - `items.attributes.options.option_id` (integer, required)
    Id único da opção
    Example: 123

  - `items.attributes.options.amount` (number)
    quantidade. Obrigatório quando não tiver valor no grid_id
    Example: 5

  - `items.attributes.options.unitary_value` (object)
    Valor unitário da opção. Obrigatório quando não tiver valor no grid_id

  - `items.attributes.options.discount` (object)
    Desconto na opção

  - `items.additionals` (array)
    Lista de adicionais deste produto nesta venda.

  - `items.additionals.additional_id` (integer, required)
    ID do adicional
    Example: 123

  - `items.additionals.amount` (integer, required)
    quantidade deste adicional
    Example: 1

  - `items.additionals.unitary_value` (object, required)
    Valor unitário deste adicional

  - `items.additionals.discount` (object)
    Valor de desconto

  - `items.additionals.total_value` (object, required)
    Valor total deste adicional.

É o resultado da multiplicação do quantidade pelo o seu valor unitário menos o valor de desconto.

total_value = (amount * unitary_value) - discount

  - `items.components` (array)
    Lista de componentes do combo. Obrigatório quando este item for um combo.

  - `items.components.combo_item_id` (integer)
    Id único do produto combo na relação, caso este item pertence a um combo. Obrigatório na atualização.
    Example: 123

  - `items.price_list_product_id` (integer)
    Id único da lista de produto do produto.

Você pode localizar os IDs da lista de preço do produto no _endpoint_ de [listagem de produtos de uma lista de preço](#tag/PriceLists/operation/get-price-list-products).
    Example: 456

  - `items.removed_components` (array)
    IDs dos componentes removidos do combo.
    Example: [1,2,3]

  - `seller_id` (integer, required)
    Id único do vendedor
    Example: 123

  - `total` (object, required)
    Resumo monetário da venda

  - `total.value` (object, required)
    Valor total da venda já considerando o desconto e o frete e o valor de outras despesas

  - `total.total_value_ipi` (object)
    Valor IPI total da venda

  - `total.discount` (object)
    Valor de desconto na venda. Deixar em nulo quando um desconto no item for aplicado

  - `total.other_expenses_value` (object)
    Outros valores

  - `source_type` (string, required)
    Canal de venda:

- erp
- pdv
- store
- totem
    Enum: "erp", "pdv", "store", "totem"

  - `payments` (array, required)
    Lista de pagamentos.

  - `payments.payment_method_id` (integer, required)
    Id único do método do pagamento
    Example: 1

  - `payments.bank_account_id` (number, required)
    Id único da conta bancária
    Example: 5

  - `payments.total_value` (object, required)
    Valor total do pagamento

  - `payments.installments` (array, required)
    Lista de parcelamento.

  - `payments.installments.due_date` (string, required)
    Data do vencimento da parcela.
    Example: "2020-01-01T09:00:00-03:00"

  - `payments.installments.value` (object, required)
    Valor da parcela

  - `payments.installments.observation` (string)
    Observação da parcela
    Example: "pagamento à vista"

  - `payments.card_brand_id` (integer)
    Id único da bandeira do cartão de crédito
    Example: 1

  - `payments.exchange_value` (object)
    Valor do troco

  - `payments.card_contract_id` (integer)
    Id do contrato do cartão
    Example: 1

  - `payments.card_receipt` (object)
    Dados do recibo do cartão

  - `payments.card_receipt.authorization` (string)
    Número da autorização do cartão. Normalmente é o número que aparece ao lado da palavra AUT, AUTORIZACAO,  A
    Example: "999996"

  - `payments.card_receipt.nsu` (string)
    Número sequencial único. Normalmente é o número que aparece ao lado da palavra DOC, CV, NSU.
    Example: "009999997"

  - `payments.card_receipt.receipt` (string)
    Dados do recebio.
    Example: "SITEF\n00001\nBIN\nVIA - ESTABELECIMENTO\nCPLUG COMERCIO DE SOFTWARE LTDA\nAvenida da CPlug\nCuritibaTT000181\nEC:000000033999999       TERM:TFI038B9\n************9999\nAUT=999996   CV=009999997   DOC=999998\n18/03/20       17:27:57              C\nVISA\nCREDITO A VISTA\nVALOR                           8.90\nTRANSACAO AUTORIZADA COM SENHA\n\n\nARQC: 35E8DF8A3234C308\nVISA CREDITO\nAID:A0000000031010\n(SiTef)"

  - `delivery_type` (any, required)
    Tipo de entrega do pedido:

- delivery entrega
- withdrawal retirada
    Enum: "delivery", "withdrawal"

  - `nature_transaction_id` (integer)
    Id da natureza da operação
    Example: 123

  - `carrier` (object)
    Dados do transportador e do frete

  - `carrier.shippingFee` (object)
    Valor do frete

  - `carrier.carrier_id` (integer)
    Id único do transportador
    Example: 1234

  - `address` (object)
    Dados do endereço do pedido

  - `address.id` (number, required)
    id do endereço.
    Example: 220

  - `address.nickname` (string)
    Apelido do endereço.
    Example: "Casa"

  - `address.type` (string, required)
    Tipo do endereço.

- default endereço principal.
- shipping endereço de entrega.
- other outro tipo de endereço.
    Enum: "default", "shipping", "other"

  - `address.street` (string, required)
    Nome do logradouro (Rua, Avenida, praça, etc).
    Example: "Avenida Paulista"

  - `address.number` (string)
    Número do logradouro.
    Example: "42 A"

  - `address.city_id` (number)
    ID da cidade.

Obrigatório quando o campo ibge_code não for passado.
    Example: 1234

  - `address.ibge_code` (string)
    Código do município segundo IBGE.

Exemplo: O código do município segundo IBGE é 3550308

Obrigatório quando o campo city_id não for passado.
    Example: "3550308"

  - `address.neighborhood` (string)
    Nome do Bairro.
    Example: "Bela Vista"

  - `address.complement` (string)
    Complemento do endereço.
    Example: "Apto 2550"

  - `address.zip_code` (string)
    CEP do endereço.
    Example: "01311000"

  - `customer_id` (integer)
    Id do cliente
    Example: 123

  - `document_number` (string)
    CPF ou CNPJ na nota
    Example: "123.456.789-00"

  - `observation` (string)
    Obervação da venda
    Example: "Sem copo"

  - `user_id` (integer)
    Id do usuário logado
    Example: 123

  - `company_id` (integer)
    Id da empresa que fez o pedido de venda
    Example: 123

  - `sale_number` (integer)
    Número do pedido de venda. Este número pode ser gerado por você. Caso não envie, o sistema irá gerar automaticamente para você.
    Example: 1234

  - `contingency_code` (integer)
    Número do pedido de venda em contigência
    Example: 12345

  - `registration_date` (string)
    Data do registro do pedido de venda.
    Example: "2020-01-01T09:00:00-03:00"

  - `status` (any)
    Tipo de status do pedido:

- canceled pedido cancelada.
- closed pedido fechada.
- in_preparation pedido em preparação.
- in_route pedido em entrega.
- open pedido aberto.
- reserved pedido reservado.
- takeout pedido para retirar.
- waiting pedido em espera.
    Enum: "canceled", "closed", "in_preparation", "in_route", "open", "reserved", "takeout", "waiting"

## Response 201 fields (application/json):

  - `id` (integer)
    Identificador numérico único do pedido de venda.
    Example: 123

  - `number` (integer)
    Número do pedido de venda.
    Example: 123

  - `unique_id` (string)
    Identificador único do pedido de venda.
    Example: "cf2e0a5e-aa58-4181-9c9b-47702bd2be99"

  - `customer` (object)
    Dados do cliente

  - `customer.id` (integer)
    Identificador único do Cliente.
    Example: 123

  - `customer.name` (string)
    Nome do cliente pessoa física ou Razão social.
    Example: "Nome do Cliente"

  - `customer.type` (string)
    Tipo do cliente. 

- individual (Pessoa física) 
- company (Pessoa jurídica)
    Enum: "individual", "company"

  - `customer.order_count` (integer)
    Quantidade de pedidos do cliente.
    Example: 10

  - `customer.last_order_id` (integer)
    ID do último pedido do cliente.
    Example: 123

  - `customer.birthday` (string)
    Data de nascimento do cliente Pessoa física. Formato "YYYY-MM-DD"
    Example: "1990-12-25"

  - `customer.companies` (array)
    Lista de empresas que permite visualizar.

  - `customer.companies.id` (integer)
    Identificador único da empresa
    Example: 1234

  - `customer.companies.name` (string)
    Nome fantasia da empresa.
    Example: "CPlug"

  - `customer.companies.company_name` (string,null)
    Razão social da empresa.
    Example: "CPlug Tecnologia da Informação"

  - `customer.company_name` (string)
    Razão social da pessoa jurídica.
    Example: "MyCompany"

  - `customer.notes` (string)
    Observações do cliente.
    Example: "Minhas obervações do cliente"

  - `customer.documents` (array)
    Lista de documentos do cliente.

  - `customer.documents.type` (string, required)
    Indica o tipo do documento.

- cpf: CPF Pessoa física
- rg: RG Pessoa física
- cnpj: CNPJ Pessoa jurídica
- ie: Inscrição Estadual Pessoa jurídica
- im: Inscrição Municipal Pessoa jurídica
    Enum: "cpf", "rg", "cnpj", "ie", "im"

  - `customer.documents.identify` (string, required)
    Identificação do documento.
    Example: "11144477735"

  - `customer.category` (object)
    Representa uma categoria de Cliente.

  - `customer.category.id` (integer)
    Identificador único da categoria de cliente.
    Example: 123

  - `customer.category.name` (string)
    Nome da categoria.
    Example: "Ouro"

  - `customer.category.is_wholesale` (boolean)
    Indica que todos os clientes vinculados à essa categoria irão pagar o valor de atacado dos produtos.

  - `customer.category.discount_in_percent` (number)
    Desconto em percentual para a categoria.

Todos os clientes vinculados à essa categoria receberão o desconto informado automáticamente.
    Example: 2.5

  - `customer.category.deleted` (boolean)
    Indica se está apagado ou não.

  - `customer.category.created_at` (string)
    Data da última criação.
    Example: "2020-01-01T09:00:00-03:00"

  - `customer.category.updated_at` (string)
    Data da última atualização.
    Example: "2020-01-01T09:00:00-03:00"

  - `customer.created_at` (string)
    Data da criação do cliente.
    Example: "2020-01-01T09:00:00-03:00"

  - `customer.updated_at` (string)
    Data da atualização do cliente.
    Example: "2020-01-01T09:00:00-03:00"

  - `address` (object)
    Endereço da venda

  - `address.id` (number)
    id do endereço.
    Example: 220

  - `address.nickname` (string)
    Apelido do endereço.
    Example: "Casa"

  - `address.type` (string, required)
    Tipo do endereço.

- default endereço principal.
- shipping endereço de entrega.
- charge endereço de cobrança.
- other outro tipo de endereço.
    Enum: "default", "shipping", "charge", "other"

  - `address.street` (string, required)
    Nome do logradouro (Rua, Avenida, praça, etc).
    Example: "Avenida Paulista"

  - `address.number` (string)
    Número do logradouro.
    Example: "42 A"

  - `address.city_id` (number)
    ID da cidade.

Obrigatório quando o campo ibge_code não for passado.
    Example: 1234

  - `address.ibge_code` (string)
    Código do município segundo IBGE.

Exemplo: O código do município segundo IBGE é 3550308

Obrigatório quando o campo city_id não for passado.
    Example: "3550308"

  - `address.state` (string)
    Sigla do estado do endereço.
    Example: "SP"

  - `address.city` (string)
    Nome da cidade.
    Example: "São Paulo"

  - `address.neighborhood` (string)
    Nome do Bairro.
    Example: "Bela Vista"

  - `address.complement` (string)
    Complemento do endereço.
    Example: "Apto 2550"

  - `address.zip_code` (string)
    CEP do endereço.
    Example: "01311000"

  - `observation` (string)
    Obervação da venda
    Example: "Sem copo"

  - `status` (any)
    Status do pedido de venda.

- canceled pedido de venda cancelada.
- closed pedido de venda fechada.
- in_preparation pedido em preparação.
- in_route pedido em entrega.
- open pedido de venda aberta.
- reserved pedido de venda reservada.
- takeout pedido para retirar.
- waiting pedido de venda em espera.
    Enum: "canceled", "closed", "in_preparation", "in_route", "open", "reserved", "takeout", "waiting"

  - `items` (array)
    Lista de produtos deste pedido de venda.

  - `items.item_id` (integer)
    Id único do produto
    Example: 123

  - `items.id` (integer)
    Id único do produto na relação
    Example: 123

  - `items.grid_id` (integer)
    Id único do grid que este item faz parte.

O grid_id é o ID do Product Grid.
    Example: 456

  - `items.amount` (number)
    quantidade
    Example: 5

  - `items.image` (string)
    imagem do produto
    Example: "mobile/totem/58723627fcebc230ab0d53ddf5f16e34/100/product_1_c1.jpeg"

  - `items.name` (string)
    Nome do produto
    Example: "Banana"

  - `items.unitary_value` (object)
    Valor unitário do item.

É a soma do valor base deste item com a soma dos adicionais e com a soma do total dos atributos.

Fórmula: unitary_value = valor base do item + sum(attributes.total_value) + sum(additionals.total_value)

  - `items.unitary_value.amount` (number, required)
    Valor expresso como um número decimal das principais unidades monetárias
    Example: 99.95

  - `items.unitary_value.currency` (string, required)
    Código de moeda de 3 letras conforme definido pela ISO-4217
    Example: "BRL"

  - `items.total_value` (object)
    Valor total do item.

É a multiplicação da quantidade pelo valor unitário deste item.

Fórmula: total_value = amount * unitary_value

  - `items.discount` (object)
    Desconto do produto

  - `items.stock_id` (integer)
    Id único do estoque
    Example: 1234

  - `items.attributes` (array)
    Lista de atributos deste produto nesta venda.

  - `items.attributes.id` (integer)
    Id único do atributo do produto na relação
    Example: 123

  - `items.attributes.attribute_id` (integer)
    Id único do atributo do produto
    Example: 123

  - `items.attributes.min_choices` (integer)
    Quantidade mínima de opções que devem ser selecionadas
    Example: 1

  - `items.attributes.max_choices` (integer)
    Quantidade máxima de opções que podem ser selecionadas
    Example: 2

  - `items.attributes.name` (string)
    Nome do atributo
    Example: "Atributo"

  - `items.attributes.charge_from_quantity` (integer)
    Indica a partir de qual opção irá começar a cobrar.

Ex: 3, indica se a partir da terceira opção que irá fazer parte do cálculo do total do atributo. 
Portanto, a primeira e a segunda opção será de graça, ou seja, essas duas opções deverão estar 
com o desconto igual ao valor total da opção.
    Example: 2

  - `items.attributes.total_value` (object)
    Valor total deste atributo.

É a soma dos valores das opções.

Fórmula: total_value = sum((option.amount * option.unitary_value) - option.discount)

  - `items.attributes.price_calculation_type` (any)
    Tipo de cálculo no total do atributo. 

Ex: average, quer dizer a o valor total do atributo será a média dos valores das opções

- Highest maior valor das opções
- Average média dos valores das opções
- Cumulative soma dos valores das opções
    Enum: "Highest", "Average", "Cumulative"

  - `items.attributes.options` (array)
    Lista de opções de um atributo.

  - `items.attributes.options.id` (integer)
    Id único da opção na relação
    Example: 123

  - `items.attributes.options.option_id` (integer)
    Id único da opção
    Example: 123

  - `items.attributes.options.code` (string)
    Código personalizado da opção
    Example: "code-123"

  - `items.attributes.options.name` (string)
    Nome da opção
    Example: "Opção 1"

  - `items.attributes.options.image` (string,null)
    URL da imagem da opção
    Example: "https://images.connectplug.com.br/4f01c1252eea.jpg"

  - `items.attributes.options.unitary_value` (object)
    Valor unitário da opção

  - `items.attributes.options.discount` (object)
    Desconto na opção

  - `items.attributes.options.notes` (string)
    Observação da opção
    Example: "Sem cebola"

  - `items.components` (array)
    Lista de componente que fazem parte deste combo, caso este item for um combo.

  - `items.components.combo_item_id` (integer)
    Id único do produto combo na relação, caso este item pertence a um combo
    Example: 3

  - `items.components.additionals` (array)
    Lista de adicionais deste produto nesta venda.

  - `items.components.additionals.additional_id` (integer)
    ID do adicional
    Example: 123

  - `items.components.additionals.amount` (integer)
    quantidade deste adicional
    Example: 1

  - `items.components.additionals.unitary_value` (object)
    Valor unitário deste adicional

  - `items.components.additionals.total_value` (object)
    Valor total deste adicional

  - `items.components.additionals.image` (string)
    imagem do adicional
    Example: "mobile/totem/58723627fcebc230ab0d53ddf5f16e34/100/product_1_c1_add1.jpeg"

  - `items.components.additionals.name` (string)
    Nome do adicional
    Example: "Adicional do produto"

  - `items.price_list_product_id` (integer)
    Id único da lista de produto do produto.

Você pode localizar os IDs da lista de preço do produto no _endpoint_ de [listagem de produtos de uma lista de preço](#tag/PriceLists/operation/get-price-list-products).
    Example: 456

  - `items.combo_id` (integer)
    Id único do combo que este item faz parte.

Você pode localizar os IDs dos combos no _endpoint_ de [listagem de produtos](#tag/Products/operation/get-products) com o filtro types=combo.
    Example: 456

  - `payments` (array)
    Lista de pagamentos.

  - `payments.id` (integer)
    Id da único do método de pagamento na relação
    Example: 1

  - `payments.payment_method` (object)
    Método de pagamento utilizado na venda

  - `payments.payment_method.id` (integer)
    Id único do método de pagamento
    Example: 123

  - `payments.payment_method.name` (string)
    Nome do método de pagamento
    Example: "Cartão de crédito"

  - `payments.payment_method.allow_installment` (boolean)
    Indica se o método de pagamento permite parcelamento.
    Example: true

  - `payments.bank_account_id` (integer)
    Id da conta bancária
    Example: 1

  - `payments.total_value` (object)
    valor total deste pagamento

  - `payments.exchange_value` (object)
    valor do troco, quando o tipo de pagamento for dinheiro

  - `payments.installments` (array)
    Lista de parcelas deste método de pagamento

  - `payments.installments.id` (integer)
    Id da único da parcela do método de pagamento na relação
    Example: 1

  - `payments.installments.value` (object)
    valor desta parcela

  - `payments.installments.due_date` (string)
    Data de vencimento da parcela
    Example: "2020-01-01T09:00:00-03:00"

  - `payments.installments.observation` (string)
    observação desta parcela
    Example: "primeira parcela"

  - `payments.card_brand` (object)
    Bandeira do cartão de crédito

  - `payments.card_brand.id` (integer)
    Identificador único da bandeira.
    Example: 123

  - `payments.card_brand.name` (string)
    Nome da bandeira.
    Example: "Master"

  - `payments.card_brand.icon` (string)
    ícone da bandeira.
    Example: "mastercard.png"

  - `payments.card_brand.nfe_code` (string)
    Código da NFe da bandeira.
    Example: "02"

  - `payments.card_contract_id` (integer)
    Id do contrato do cartão
    Example: 1

  - `payments.card_receipt` (object)
    Dados do recibo do cartão

  - `payments.card_receipt.authorization` (string)
    Número da autorização do cartão. Normalmente é o número que aparece ao lado da palavra AUT, AUTORIZACAO,  A
    Example: "999996"

  - `payments.card_receipt.nsu` (string)
    Número sequencial único. Normalmente é o número que aparece ao lado da palavra DOC, CV, NSU.
    Example: "009999997"

  - `payments.card_receipt.receipt` (string)
    Dados do recebio.
    Example: "SITEF\n00001\nBIN\nVIA - ESTABELECIMENTO\nCPLUG COMERCIO DE SOFTWARE LTDA\nAvenida da CPlug\nCuritibaTT000181\nEC:000000033999999       TERM:TFI038B9\n************9999\nAUT=999996   CV=009999997   DOC=999998\n18/03/20       17:27:57              C\nVISA\nCREDITO A VISTA\nVALOR                           8.90\nTRANSACAO AUTORIZADA COM SENHA\n\n\nARQC: 35E8DF8A3234C308\nVISA CREDITO\nAID:A0000000031010\n(SiTef)"

  - `seller` (object)
    Dados do vendedor

  - `seller.id` (integer)
    Identificador único do vendedor.
    Example: 123

  - `seller.name` (string)
    Nome do vendedor.
    Example: "Fulano de tal"

  - `seller.email` (string)
    E-mail do vendedor.
    Example: "vendedor@email.com"

  - `seller.username` (null,string)
    Nome de usuário do vendedor.
    Example: "Vendedor"

  - `seller.created_at` (string)
    Data da criação da vendedor.
    Example: "2020-01-01T09:00:00-03:00"

  - `seller.updated_at` (string)
    Data da atualização da vendedor.
    Example: "2020-01-01T09:00:00-03:00"

  - `seller.deleted_at` (string)
    Data que foi apagado o vendedor.
    Example: "2020-01-01T09:00:00-03:00"

  - `carrier` (object)
    Dados do frete e do transportador

  - `carrier.shipping_fee` (object)
    valor do frete

  - `carrier.carrier_id` (integer)
    Id do transportador
    Example: 1

  - `total` (object)
    Resumo monetário da venda

  - `total.value` (object)
    Valor total da venda já considerando o desconto e o frete e o valor de outras despesas

  - `total.discount` (object)
    Valor de desconto na venda. Deixar em nulo quando um desconto no item for aplicado

  - `total.total_value_ipi` (object)
    Valor total de IPI

  - `total.other_expenses_value` (object)
    Valor total de outras despesas

  - `source_type` (string)
    Canal de venda:

- erp
- pdv
- store
- totem
    Enum: "erp", "pdv", "store", "totem"

  - `registration_date` (string)
    Data do registro da venda.
    Example: "2020-01-01T09:00:00-03:00"

  - `delivery_type` (any)
    Tipo de entrega do pedido:

- delivery entrega
- withdrawal retirada
    Enum: "delivery", "withdrawal"

  - `sale_id` (integer)
    Identificador numérico único de venda.
    Example: 789

  - `delivery_area` (object)
    Representa uma área de entrega.

  - `delivery_area.id` (integer)
    Identificador único da área de entrega.
    Example: 1

  - `delivery_area.name` (string)
    Nome da área de entrega.
    Example: "Centro"

  - `delivery_area.type` (string)
    Tipo da área de entrega.

- circle: Área de entrega circular (radio de entrega).
- polygon: Área de entrega customizada.
    Enum: "circle", "polygon"

  - `delivery_area.center_point` (object)
    Localização do centro da área de entrega.

Esse compo é obrigatório para áreas de entrega com tipo circle. Esse compo não será considerado para áreas de entrega com tipo polygon.

  - `delivery_area.center_point.lat` (number, required)
    Latitude de um ponto geográfico.
    Example: -23.5505199

  - `delivery_area.center_point.lng` (number, required)
    Longitude de um ponto geográfico.
    Example: -46.6333093

  - `delivery_area.radius` (integer)
    Raio da área de entrega em quilômetros (km).

Esse compo é obrigatório para áreas de entrega com tipo circle. Esse compo não será considerado para áreas de entrega com tipo polygon.
    Example: 10

  - `delivery_area.polygon` (array)
    Polígono da área de entrega.

Esse compo é obrigatório para áreas de entrega com tipo polygon. Esse compo não será considerado para áreas de entrega com tipo circle.

  - `delivery_area.price` (object)
    Valor da taxa de entrega.

  - `delivery_area.min_waiting_time` (integer)
    Tempo em minutos estimado mínimo de espera para a entrega.
    Example: 30

  - `delivery_area.max_waiting_time` (integer)
    Tempo em minutos estimado máximo de espera para a entrega.
    Example: 60

  - `created_at` (string)
    Data da criação da venda.
    Example: "2020-01-01T09:00:00-03:00"

  - `updated_at` (string)
    Data da atualização da venda.
    Example: "2020-01-01T09:00:00-03:00"

## Response 400 fields (application/json):

  - `code` (string, required)
    Código de erro.
    Example: "missing_headers"

  - `message` (string)
    Descrição do erro.
    Example: "error message"

  - `meta` (array)
    Dados adicionais sobre o erro.

## Response 422 fields (application/json):

  - `code` (string, required)
    Código de erro.
    Example: "uneditable_entity"

  - `message` (string)
    Descrição do erro.
    Example: "description error"

  - `meta` (array)
    Dados adicionais sobre o erro.

  - `meta.field` (string, required)
    Nome do campo no qual existe um erro de validação.
    Example: "name"

  - `meta.validations` (array)

  - `meta.validations.type` (string, required)
    Tipo da validação aplicada.
    Example: "Required"

  - `meta.validations.value` (array)
    Tipo de valor aplicável (esse campo pode ser vazio).


## Response 401 fields

## Response 404 fields