# 11. 🛍️ Pedidos de Venda

**Sistema completo de vendas e pedidos** Gestão do ciclo completo de vendas com integração fiscal. **Pipeline comercial:**

* Orçamentos → Pedidos → NF-e → Faturamento
* Integração automática com estoque
* Comissionamento de vendedores
* Análise de performance comercial

## Consulta de Nota Fiscal do Pedido

> \*\*Endpoint para consulta de nota fiscal vinculada a um pedido\*\*\
> \
> Retorna as informações da Nota Fiscal Eletrônica (NF-e) associada ao pedido,\
> incluindo status atual, chave de acesso e link para o DANFE.\
> \
> \*\*Informações retornadas:\*\*\
> \- UUID da nota fiscal\
> \- Chave de acesso (versão segura)\
> \- Status atual da NF-e\
> \- URL pública do DANFE para visualização/download\
> \
> \*\*Status possíveis da NF-e:\*\*\
> \- NAO\_TRANSMITIDA: NF-e criada mas não enviada à SEFAZ\
> \- EM\_TRANSMISSAO: NF-e sendo processada pela SEFAZ\
> \- ACEITA: NF-e aceita e válida fiscalmente\
> \- REJEITADA: NF-e rejeitada pela SEFAZ\
> \- CANCELADA: NF-e cancelada após aceita\
> \- DENEGADA: NF-e denegada pela SEFAZ\
> \
> \*\*Uso típico:\*\*\
> \- Consulta de status de transmissão\
> \- Obtenção de link para DANFE\
> \- Verificação de dados da NF-e gerada

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"11. 🛍️ Pedidos de Venda","description":"**Sistema completo de vendas e pedidos**\nGestão do ciclo completo de vendas com integração fiscal.\n**Pipeline comercial:**\n- Orçamentos → Pedidos → NF-e → Faturamento\n- Integração automática com estoque\n- Comissionamento de vendedores\n- Análise de performance comercial"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/pedidos/{pedido_id}/nota_fiscal":{"get":{"summary":"Consulta de Nota Fiscal do Pedido","tags":["11. 🛍️ Pedidos de Venda"],"description":"**Endpoint para consulta de nota fiscal vinculada a um pedido**\n\nRetorna as informações da Nota Fiscal Eletrônica (NF-e) associada ao pedido,\nincluindo status atual, chave de acesso e link para o DANFE.\n\n**Informações retornadas:**\n- UUID da nota fiscal\n- Chave de acesso (versão segura)\n- Status atual da NF-e\n- URL pública do DANFE para visualização/download\n\n**Status possíveis da NF-e:**\n- NAO_TRANSMITIDA: NF-e criada mas não enviada à SEFAZ\n- EM_TRANSMISSAO: NF-e sendo processada pela SEFAZ\n- ACEITA: NF-e aceita e válida fiscalmente\n- REJEITADA: NF-e rejeitada pela SEFAZ\n- CANCELADA: NF-e cancelada após aceita\n- DENEGADA: NF-e denegada pela SEFAZ\n\n**Uso típico:**\n- Consulta de status de transmissão\n- Obtenção de link para DANFE\n- Verificação de dados da NF-e gerada","responses":{"200":{"description":"Dados da nota fiscal","content":{"application/json":{"schema":{"type":"object","properties":{"nota_fiscal":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"UUID da nota fiscal"},"chave_acesso":{"type":"string","description":"Chave de acesso da NF-e (44 dígitos) - versão segura","nullable":true},"status":{"type":"string","description":"Status atual da NF-e","enum":["NAO_TRANSMITIDA","EM_TRANSMISSAO","ACEITA","REJEITADA","CANCELADA","DENEGADA"]},"danfe_url":{"type":"string","format":"uri","description":"URL pública para visualização/download do DANFE"}},"required":["id","status","danfe_url"]}},"required":["nota_fiscal"]}}}},"401":{"description":"Usuário não autenticado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Nota fiscal não encontrada"}}}}}}
```

## Criação de Nota Fiscal de Pedido

> \*\*Endpoint para finalização de pedido com geração automática de NF-e\*\*\
> \
> Este endpoint realiza a finalização de um pedido de venda, executando todas as\
> validações fiscais necessárias e gerando automaticamente a Nota Fiscal Eletrônica (NF-e).\
> \
> \*\*Processo de finalização:\*\*\
> 1\. Validação completa do pedido (produtos, quantidades, dados fiscais)\
> 2\. Verificação de status do cliente (ativo, dados completos)\
> 3\. Validação de estoque disponível\
> 4\. Geração automática da NF-e com dados fiscais corretos\
> 5\. Atualização do status do pedido para "finalizado"\
> \
> \*\*Validações realizadas:\*\*\
> \- Integridade dos dados do pedido\
> \- Disponibilidade de estoque\
> \- Dados fiscais do cliente\
> \- Configurações tributárias\
> \- Certificado digital válido\
> \
> \*\*Comportamento transacional:\*\*\
> \- Operação executada com lock no pedido\
> \- Rollback automático em caso de erro\
> \- Garantia de consistência dos dados\
> \
> \*\*Uso típico:\*\*\
> \- Finalização de pedidos aprovados\
> \- Geração de NF-e para faturamento\
> \- Processamento de vendas em lote

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"11. 🛍️ Pedidos de Venda","description":"**Sistema completo de vendas e pedidos**\nGestão do ciclo completo de vendas com integração fiscal.\n**Pipeline comercial:**\n- Orçamentos → Pedidos → NF-e → Faturamento\n- Integração automática com estoque\n- Comissionamento de vendedores\n- Análise de performance comercial"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/pedidos/{pedido_id}/nota_fiscal":{"post":{"summary":"Criação de Nota Fiscal de Pedido","tags":["11. 🛍️ Pedidos de Venda"],"description":"**Endpoint para finalização de pedido com geração automática de NF-e**\n\nEste endpoint realiza a finalização de um pedido de venda, executando todas as\nvalidações fiscais necessárias e gerando automaticamente a Nota Fiscal Eletrônica (NF-e).\n\n**Processo de finalização:**\n1. Validação completa do pedido (produtos, quantidades, dados fiscais)\n2. Verificação de status do cliente (ativo, dados completos)\n3. Validação de estoque disponível\n4. Geração automática da NF-e com dados fiscais corretos\n5. Atualização do status do pedido para \"finalizado\"\n\n**Validações realizadas:**\n- Integridade dos dados do pedido\n- Disponibilidade de estoque\n- Dados fiscais do cliente\n- Configurações tributárias\n- Certificado digital válido\n\n**Comportamento transacional:**\n- Operação executada com lock no pedido\n- Rollback automático em caso de erro\n- Garantia de consistência dos dados\n\n**Uso típico:**\n- Finalização de pedidos aprovados\n- Geração de NF-e para faturamento\n- Processamento de vendas em lote","responses":{"401":{"description":"Usuário não autenticado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Pedido não encontrado"},"422":{"description":"Erro de validação do pedido","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"object","description":"Detalhes dos erros de validação encontrados","additionalProperties":{"type":"array","items":{"type":"string"}}}},"required":["errors"]}}}}}}}}}
```

## Cancelamento de Nota Fiscal do Pedido

> \*\*Endpoint para cancelamento de nota fiscal e reversão do pedido\*\*\
> \
> Este endpoint realiza o cancelamento de uma nota fiscal já gerada, revertendo\
> o pedido para seu estado anterior. A operação é executada com segurança transacional.\
> \
> \*\*Processo de cancelamento:\*\*\
> 1\. Verificação se a NF-e pode ser cancelada (regras fiscais)\
> 2\. Cancelamento da NF-e na SEFAZ (se já transmitida)\
> 3\. Reversão do pedido para status anterior\
> 4\. Reposição de estoque (se aplicável)\
> \
> \*\*Condições para cancelamento:\*\*\
> \- NF-e deve estar em status que permite cancelamento\
> \- Prazo fiscal para cancelamento não deve ter expirado\
> \- Não deve haver dependências que impeçam o cancelamento\
> \
> \*\*Comportamento transacional:\*\*\
> \- Operação executada com lock no pedido\
> \- Rollback automático em caso de erro\
> \- Garantia de consistência dos dados\
> \
> \*\*Uso típico:\*\*\
> \- Correção de pedidos finalizados incorretamente\
> \- Cancelamento por solicitação do cliente\
> \- Ajustes em casos de erro no faturamento

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"11. 🛍️ Pedidos de Venda","description":"**Sistema completo de vendas e pedidos**\nGestão do ciclo completo de vendas com integração fiscal.\n**Pipeline comercial:**\n- Orçamentos → Pedidos → NF-e → Faturamento\n- Integração automática com estoque\n- Comissionamento de vendedores\n- Análise de performance comercial"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/pedidos/{pedido_id}/nota_fiscal":{"delete":{"summary":"Cancelamento de Nota Fiscal do Pedido","tags":["11. 🛍️ Pedidos de Venda"],"description":"**Endpoint para cancelamento de nota fiscal e reversão do pedido**\n\nEste endpoint realiza o cancelamento de uma nota fiscal já gerada, revertendo\no pedido para seu estado anterior. A operação é executada com segurança transacional.\n\n**Processo de cancelamento:**\n1. Verificação se a NF-e pode ser cancelada (regras fiscais)\n2. Cancelamento da NF-e na SEFAZ (se já transmitida)\n3. Reversão do pedido para status anterior\n4. Reposição de estoque (se aplicável)\n\n**Condições para cancelamento:**\n- NF-e deve estar em status que permite cancelamento\n- Prazo fiscal para cancelamento não deve ter expirado\n- Não deve haver dependências que impeçam o cancelamento\n\n**Comportamento transacional:**\n- Operação executada com lock no pedido\n- Rollback automático em caso de erro\n- Garantia de consistência dos dados\n\n**Uso típico:**\n- Correção de pedidos finalizados incorretamente\n- Cancelamento por solicitação do cliente\n- Ajustes em casos de erro no faturamento","responses":{"204":{"description":"Nota fiscal cancelada com sucesso"},"401":{"description":"Usuário não autenticado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Pedido não encontrado"}}}}}}
```

## Lista pedidos

> Lista pedidos de venda com filtros básicos.

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"11. 🛍️ Pedidos de Venda","description":"**Sistema completo de vendas e pedidos**\nGestão do ciclo completo de vendas com integração fiscal.\n**Pipeline comercial:**\n- Orçamentos → Pedidos → NF-e → Faturamento\n- Integração automática com estoque\n- Comissionamento de vendedores\n- Análise de performance comercial"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/pedidos":{"get":{"summary":"Lista pedidos","tags":["11. 🛍️ Pedidos de Venda"],"description":"Lista pedidos de venda com filtros básicos.","parameters":[{"name":"status","in":"query","description":"Filtrar por status do pedido","required":false,"schema":{"type":"string"}},{"name":"exportacao","in":"query","description":"Filtrar pedidos de exportação (true) ou mercado interno (false)","required":false,"schema":{"type":"boolean"}},{"name":"page","in":"query","description":"Número da página para paginação","required":false,"schema":{"type":"integer"}},{"name":"per_page","in":"query","description":"Quantidade de registros por página (máx: 100, padrão: 30)","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Lista de pedidos","content":{"application/json":{"schema":{"type":"object","properties":{"pedidos":{"type":"array","description":"Lista de pedidos","items":{"type":"object","properties":{"id":{"type":"string","description":"UUID do pedido"},"numero":{"type":"string","description":"Número do pedido"},"status":{"type":"string","description":"Status do pedido"},"exportacao":{"type":"boolean","description":"Se é pedido de exportação"},"moeda":{"type":"string","description":"Código ISO da moeda"},"taxa_cambio":{"type":"number","format":"float","description":"Taxa de câmbio"},"cliente":{"type":"object","nullable":true,"description":"Dados do cliente","properties":{"documento":{"type":"string","description":"CPF/CNPJ do cliente"},"razao_social":{"type":"string","description":"Razão social"},"nome_fantasia":{"type":"string","nullable":true,"description":"Nome fantasia"},"inscricao_estadual":{"type":"string","nullable":true,"description":"Inscrição estadual"},"endereco":{"type":"string","nullable":true,"description":"Logradouro"},"numero":{"type":"string","nullable":true,"description":"Número"},"complemento":{"type":"string","nullable":true,"description":"Complemento"},"cep":{"type":"string","nullable":true,"description":"CEP"},"bairro":{"type":"string","nullable":true,"description":"Bairro"},"municipio":{"type":"integer","nullable":true,"description":"Código IBGE do município"}}},"endereco_de_entrega":{"type":"object","nullable":true,"description":"Endereço de entrega","properties":{"documento":{"type":"string","description":"CPF/CNPJ"},"razao_social":{"type":"string","description":"Razão social"},"endereco":{"type":"string","description":"Logradouro"},"numero":{"type":"string","nullable":true,"description":"Número"},"complemento":{"type":"string","nullable":true,"description":"Complemento"},"cep":{"type":"string","nullable":true,"description":"CEP"},"bairro":{"type":"string","nullable":true,"description":"Bairro"},"municipio":{"type":"integer","nullable":true,"description":"Código IBGE do município"}}},"transportadora":{"type":"object","nullable":true,"description":"Dados da transportadora","properties":{"documento":{"type":"string","description":"CPF/CNPJ"},"razao_social":{"type":"string","description":"Razão social"},"nome_fantasia":{"type":"string","nullable":true,"description":"Nome fantasia"},"inscricao_estadual":{"type":"string","nullable":true,"description":"Inscrição estadual"},"endereco":{"type":"string","nullable":true,"description":"Logradouro"},"numero":{"type":"string","nullable":true,"description":"Número"},"complemento":{"type":"string","nullable":true,"description":"Complemento"},"cep":{"type":"string","nullable":true,"description":"CEP"},"bairro":{"type":"string","nullable":true,"description":"Bairro"},"municipio":{"type":"integer","nullable":true,"description":"Código IBGE do município"}}},"representante":{"type":"object","nullable":true,"description":"Representante/vendedor","properties":{"nome":{"type":"string","description":"Nome do representante"},"email":{"type":"string","description":"Email do representante"}}},"itens":{"type":"array","description":"Itens do pedido","items":{"type":"object","properties":{"codigo":{"type":"string","description":"Código do produto"},"descricao":{"type":"string","description":"Descrição do produto"},"quantidade":{"type":"number","format":"float","description":"Quantidade"},"status":{"type":"string","description":"Status do item (OK ou INVALIDO)"},"erros":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Erros de validação do item"}}}},"cobranca":{"type":"object","nullable":true,"description":"Dados de cobrança/fatura","properties":{"numero_fatura":{"type":"string","description":"Número da fatura"},"dt_inicio_pagamento":{"type":"string","format":"date","description":"Data de início do pagamento"},"forma_pagamento":{"type":"string","nullable":true,"description":"Forma de pagamento"},"tipo_de_receita":{"type":"string","nullable":true,"description":"Tipo de receita"},"plano_de_conta":{"type":"string","nullable":true,"description":"Plano de conta"},"parcelas":{"type":"array","description":"Parcelas da fatura","items":{"type":"object","properties":{"numero_titulo":{"type":"string","description":"Número do título"},"valor":{"type":"number","format":"float","description":"Valor da parcela"},"data_vencimento":{"type":"string","format":"date","description":"Data de vencimento"}}}}}},"condicao_de_proposta":{"type":"object","nullable":true,"description":"Condição de proposta (exportação)","properties":{"descricao":{"type":"string","description":"Descrição da condição"},"incoterms":{"type":"string","nullable":true,"description":"Incoterms"},"pais_origem":{"type":"string","nullable":true,"description":"País de origem"},"pais_despacho":{"type":"string","nullable":true,"description":"País de despacho"},"pais_aquisicao":{"type":"string","nullable":true,"description":"País de aquisição"},"treinamento":{"type":"string","nullable":true,"description":"Treinamento"},"dt_validade_da_proposta":{"type":"string","format":"date","nullable":true,"description":"Data de validade"},"garantia":{"type":"string","nullable":true,"description":"Garantia"},"entrega":{"type":"string","nullable":true,"description":"Condições de entrega"},"descricao_moeda":{"type":"string","nullable":true,"description":"Descrição da moeda"}}},"transporte":{"type":"object","nullable":true,"description":"Dados de transporte do pedido","properties":{"quantidade_volumes":{"type":"number","description":"Quantidade de volumes","nullable":true},"especie_volumes":{"type":"string","description":"Espécie dos volumes","nullable":true},"numeracao_volumes":{"type":"string","description":"Numeração dos volumes","nullable":true},"marca_volumes":{"type":"string","description":"Marca dos volumes","nullable":true},"peso_bruto":{"type":"number","format":"float","description":"Peso bruto total","nullable":true},"peso_liquido":{"type":"number","format":"float","description":"Peso líquido total","nullable":true}}}}}},"pagination":{"type":"object","description":"Informações de paginação","properties":{"total":{"type":"integer","description":"Total de registros"},"previous_page":{"type":"string","nullable":true,"description":"URL da página anterior"},"next_page":{"type":"string","nullable":true,"description":"URL da próxima página"}}}}}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```

## Cria pedido

> Cria um novo pedido de venda.\
> \
> \*\*Parâmetros de controle:\*\*\
> \- \`transmite\`: "0" (apenas pedido) ou "1" (pedido + NF-e) - \*\*Obrigatório\*\*\
> \- \`async\`: "0" (síncrono) ou "1" (assíncrono) - Opcional\
> \- \`url\`: Webhook para callback (obrigatório se async=1 ou transmite=1)\
> \- \`gerar\_nota\_fiscal\_sem\_transmissao\`: true/false - Gera NF-e sem transmitir\
> \- \`numero\_processo\`: Número de processo já cadastrado no sistema

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"11. 🛍️ Pedidos de Venda","description":"**Sistema completo de vendas e pedidos**\nGestão do ciclo completo de vendas com integração fiscal.\n**Pipeline comercial:**\n- Orçamentos → Pedidos → NF-e → Faturamento\n- Integração automática com estoque\n- Comissionamento de vendedores\n- Análise de performance comercial"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/pedidos":{"post":{"summary":"Cria pedido","tags":["11. 🛍️ Pedidos de Venda"],"description":"Cria um novo pedido de venda.\n\n**Parâmetros de controle:**\n- `transmite`: \"0\" (apenas pedido) ou \"1\" (pedido + NF-e) - **Obrigatório**\n- `async`: \"0\" (síncrono) ou \"1\" (assíncrono) - Opcional\n- `url`: Webhook para callback (obrigatório se async=1 ou transmite=1)\n- `gerar_nota_fiscal_sem_transmissao`: true/false - Gera NF-e sem transmitir\n- `numero_processo`: Número de processo já cadastrado no sistema","parameters":[{"name":"transmite","in":"query","enum":["0","1"],"description":"0=apenas pedido, 1=pedido+NF-e:\n * `0` \n * `1` \n ","required":true,"schema":{"type":"string"}},{"name":"async","in":"query","enum":["0","1"],"description":"0=síncrono, 1=assíncrono","required":false,"schema":{"type":"string"}},{"name":"url","in":"query","description":"URL de callback (obrigatório se async=1 ou transmite=1)","required":false,"schema":{"type":"string"}},{"name":"gerar_nota_fiscal_sem_transmissao","in":"query","description":"Gera NF-e sem transmitir","required":false,"schema":{"type":"boolean"}},{"name":"numero_processo","in":"query","description":"Número do processo já cadastrado","required":false,"schema":{"type":"string"}},{"name":"origem","in":"query","description":"Origem da requisição (vtex, maino_ia, etc)","required":false,"schema":{"type":"string"}}],"responses":{"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"numero":{"type":"string","description":"Número do pedido (campo com unicidade)"},"orcamento":{"type":"boolean","description":"true=orçamento, false=pedido (padrão: false)"},"exportacao":{"type":"boolean","description":"true=exportação, false=mercado interno (padrão: false)"},"revenda":{"type":"boolean","description":"true se pedido para revenda"},"consumidor_final":{"type":"boolean","description":"true se cliente é consumidor final"},"tabela_de_venda":{"type":"string","description":"Código da tabela de venda"},"status":{"type":"string","description":"Status personalizado do pedido"},"modalidade_frete":{"type":"integer","enum":[0,1,2,3,4,9],"description":"0=CIF, 1=FOB, 2=Terceiros, 3=Próprio Remetente, 4=Próprio Destinatário, 9=Sem Transporte"},"valor_frete":{"type":"number","format":"float"},"valor_outras_despesas":{"type":"number","format":"float"},"valor_seguro":{"type":"number","format":"float"},"informacoes_complementares":{"type":"string"},"informacoes_ao_fisco":{"type":"string"},"quantidade_volumes":{"type":"number"},"especie_volumes":{"type":"string"},"numeracao_volumes":{"type":"string"},"marca_volumes":{"type":"string"},"codigo_iso_moeda":{"type":"string","description":"Código ISO da moeda (ex: BRL, USD)"},"taxa_cambio":{"type":"number","format":"float"},"cfop":{"type":"string","description":"CFOP da nota fiscal (sobrescreve automático)"},"natureza_da_operacao":{"type":"string"},"representante_email":{"type":"string","description":"Email do representante/vendedor cadastrado"},"tags":{"type":"array","items":{"type":"string"},"description":"Tags do pedido"},"indicador_presenca":{"type":"integer","enum":[0,1,2,3,5,9],"description":"Indicador de presença"},"indicador_intermediador":{"type":"integer","enum":[0,1],"description":"0=sem intermediador, 1=com intermediador"},"inf_intermed_cnpj":{"type":"string","description":"CNPJ do intermediador"},"inf_intermed_id_cad_int_tran":{"type":"string","description":"ID do intermediador"},"observacao":{"type":"string"},"valor_comissao":{"type":"number","format":"float"},"data":{"type":"string","format":"date","description":"Data do pedido (padrão: hoje)"},"data_de_entrega":{"type":"string","format":"date"},"exibe_calculo_antecipacao_icms":{"type":"boolean"},"calculo_antecipacao_icms_inclui_frete":{"type":"boolean"},"calculo_antecipacao_icms_inclui_ipi":{"type":"boolean"},"transporte":{"type":"object","description":"Dados de transporte","properties":{"quantidade_volumes":{"type":"number","description":"Quantidade de volumes"},"quantidade_volume":{"type":"number","description":"Alias para quantidade_volumes"},"especie_volumes":{"type":"string","description":"Espécie dos volumes"},"numeracao_volumes":{"type":"string","description":"Numeração dos volumes"},"marca_volumes":{"type":"string","description":"Marca dos volumes"},"peso_bruto":{"type":"number","format":"float","description":"Peso bruto total"},"peso_liquido":{"type":"number","format":"float","description":"Peso líquido total"}}},"cliente":{"type":"object","description":"Dados do cliente","properties":{"somente_busca":{"type":"boolean","description":"true=busca cliente existente, false=cria novo (padrão: false)"},"cpf":{"type":"string","description":"CPF (pessoa física) - apenas números"},"cnpj":{"type":"string","description":"CNPJ (pessoa jurídica) - apenas números"},"razao_social":{"type":"string","description":"Razão social ou nome"},"nome_fantasia":{"type":"string"},"indicador_ie":{"type":"integer","enum":[1,2,3],"description":"1=Contribuinte ICMS, 2=Isento, 3=Não contribuinte (padrão: 3)"},"inscricao_estadual":{"type":"string"},"inscricao_suframa":{"type":"string"},"cep":{"type":"string","description":"CEP - apenas números"},"uf":{"type":"string","description":"Sigla UF (ex: SP)"},"endereco":{"type":"string","description":"Logradouro"},"numero":{"type":"string"},"complemento":{"type":"string"},"bairro":{"type":"string"},"municipio":{"type":"integer","description":"Código IBGE do município"},"email":{"type":"string"},"ddd":{"type":"string"},"telefone":{"type":"string"}},"required":["razao_social"]},"transportadora":{"type":"object","description":"Dados da transportadora (opcional)","properties":{"somente_busca":{"type":"boolean","description":"true=busca existente, false=cria nova"},"cpf":{"type":"string"},"cnpj":{"type":"string"},"razao_social":{"type":"string"},"nome_fantasia":{"type":"string"},"indicador_ie":{"type":"integer","enum":[1,2,3]},"inscricao_estadual":{"type":"string"},"inscricao_suframa":{"type":"string"},"cep":{"type":"string"},"uf":{"type":"string"},"endereco":{"type":"string"},"numero":{"type":"string"},"complemento":{"type":"string"},"bairro":{"type":"string"},"municipio":{"type":"integer"},"email":{"type":"string"},"ddd":{"type":"string"},"telefone":{"type":"string"}}},"endereco_de_entrega":{"type":"object","description":"Endereço de entrega diferente do cliente (opcional)","properties":{"outro_cliente":{"type":"boolean","description":"true=entrega para terceiro (requer cpf/cnpj/razao_social)"},"cep":{"type":"string"},"uf":{"type":"string"},"municipio":{"type":"integer"},"cpf":{"type":"string"},"cnpj":{"type":"string"},"razao_social":{"type":"string"},"endereco":{"type":"string"},"numero":{"type":"string"},"complemento":{"type":"string"},"bairro":{"type":"string"}}},"itens":{"type":"array","description":"Itens do pedido","items":{"type":"object","properties":{"codigo":{"type":"string","description":"Código do produto"},"descricao":{"type":"string"},"tabela_de_venda":{"type":"string","description":"Tabela de venda específica do item"},"pu":{"type":"number","format":"float","description":"Preço unitário"},"valor_desconto":{"type":"number","format":"float","description":"Valor de desconto em reais"},"quantidade":{"type":"number","format":"float"},"quantidade_caixas":{"type":"number"},"ignora_controle_de_estoque":{"type":"boolean","description":"true=cria produto mesmo sem estoque"},"peso_bruto":{"type":"number","format":"float"},"peso_liquido":{"type":"number","format":"float"},"numero_do_pedido_compra":{"type":"string"},"sequencial_pedido_compra":{"type":"string"},"unidade_de_medida":{"type":"string","description":"Obrigatório se ignora_controle_de_estoque=true"},"ncm":{"type":"string","description":"Obrigatório se ignora_controle_de_estoque=true"},"p_ipi":{"type":"number","format":"float","description":"Obrigatório se ignora_controle_de_estoque=true"},"pu_entrada":{"type":"number","format":"float","description":"Obrigatório se ignora_controle_de_estoque=true"},"origem":{"type":"string","description":"Obrigatório se ignora_controle_de_estoque=true"},"codigo_de_barras":{"type":"string"},"informacoes_complementares":{"type":"string"},"mva":{"type":"number","format":"float","description":"Margem de Valor Agregado (%)"},"tipo_mva":{"type":"integer","enum":[0,1],"description":"0=original, 1=ajustada (padrão: 0)"}},"required":["codigo","descricao","pu","quantidade"]}},"condicao_de_proposta":{"type":"object","description":"Condições de proposta (exportação)","properties":{"pais_origem":{"type":"string"},"pais_aquisicao":{"type":"string"},"pais_despacho":{"type":"string"}}},"cobranca":{"type":"object","description":"Dados de cobrança/fatura","properties":{"forma_pagamento":{"type":"integer","description":"Código da forma de pagamento (1=Duplicata, 2=Boleto, 3=Dinheiro, 24=PIX, etc)"},"numero_fatura":{"type":"string"},"tipo_de_receita":{"type":"string"},"plano_de_conta":{"type":"string","description":"Código do plano de contas (deve estar ativo)"},"sufixo":{"type":"string"},"conta_bancaria":{"type":"object","properties":{"banco":{"type":"string","description":"Código do banco"},"agencia":{"type":"string","description":"Número da agência sem dígito"},"numero_conta":{"type":"string","description":"Número da conta sem dígito"}}},"centro_de_custo":{"type":"string"},"parcelas":{"type":"array","items":{"type":"object","properties":{"valor":{"type":"number","format":"float"},"data_vencimento":{"type":"string","format":"date"}},"required":["valor","data_vencimento"]}},"utilizar_valor_nota_fiscal":{"type":"boolean","description":"true=valor da fatura igual ao da NF-e (somente pagamento à vista)"}},"required":["forma_pagamento","plano_de_conta","parcelas"]}},"required":["numero","cliente","itens"]}}}}}}}}
```

## Exibe pedido

> Retorna detalhes completos de um pedido

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"11. 🛍️ Pedidos de Venda","description":"**Sistema completo de vendas e pedidos**\nGestão do ciclo completo de vendas com integração fiscal.\n**Pipeline comercial:**\n- Orçamentos → Pedidos → NF-e → Faturamento\n- Integração automática com estoque\n- Comissionamento de vendedores\n- Análise de performance comercial"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/pedidos/{id}":{"get":{"summary":"Exibe pedido","tags":["11. 🛍️ Pedidos de Venda"],"description":"Retorna detalhes completos de um pedido","responses":{"200":{"description":"Detalhes do pedido","content":{"application/json":{"schema":{"type":"object","properties":{"pedido":{"type":"object","properties":{"id":{"type":"string","description":"UUID do pedido"},"numero":{"type":"string","description":"Número do pedido"},"status":{"type":"string","description":"Status do pedido"},"exportacao":{"type":"boolean"},"moeda":{"type":"string"},"taxa_cambio":{"type":"number","format":"float","nullable":true},"cliente":{"type":"object","nullable":true,"properties":{"cpf":{"type":"string","nullable":true,"description":"CPF (pessoa física)"},"cnpj":{"type":"string","nullable":true,"description":"CNPJ (pessoa jurídica)"},"razao_social":{"type":"string","description":"Razão social"},"nome_fantasia":{"type":"string","nullable":true,"description":"Nome fantasia"},"inscricao_estadual":{"type":"string","nullable":true,"description":"Inscrição estadual"},"endereco":{"type":"string","nullable":true,"description":"Logradouro"},"numero":{"type":"string","nullable":true,"description":"Número"},"complemento":{"type":"string","nullable":true,"description":"Complemento"},"cep":{"type":"string","nullable":true,"description":"CEP"},"bairro":{"type":"string","nullable":true,"description":"Bairro"},"municipio":{"type":"integer","nullable":true,"description":"Código IBGE do município"},"email":{"type":"string","nullable":true,"description":"Email"},"ddd":{"type":"string","nullable":true,"description":"DDD"},"telefone":{"type":"string","nullable":true,"description":"Telefone"}}},"endereco_de_entrega":{"type":"object","nullable":true,"properties":{"cpf":{"type":"string","nullable":true,"description":"CPF"},"cnpj":{"type":"string","nullable":true,"description":"CNPJ"},"razao_social":{"type":"string","description":"Razão social"},"endereco":{"type":"string","description":"Logradouro"},"numero":{"type":"string","nullable":true,"description":"Número"},"complemento":{"type":"string","nullable":true,"description":"Complemento"},"cep":{"type":"string","nullable":true,"description":"CEP"},"bairro":{"type":"string","nullable":true,"description":"Bairro"},"municipio":{"type":"integer","nullable":true,"description":"Código IBGE"}}},"transportadora":{"type":"object","nullable":true,"properties":{"cpf":{"type":"string","nullable":true,"description":"CPF"},"cnpj":{"type":"string","nullable":true,"description":"CNPJ"},"razao_social":{"type":"string","description":"Razão social"},"nome_fantasia":{"type":"string","nullable":true,"description":"Nome fantasia"},"inscricao_estadual":{"type":"string","nullable":true,"description":"Inscrição estadual"},"endereco":{"type":"string","nullable":true,"description":"Logradouro"},"numero":{"type":"string","nullable":true,"description":"Número"},"complemento":{"type":"string","nullable":true,"description":"Complemento"},"cep":{"type":"string","nullable":true,"description":"CEP"},"bairro":{"type":"string","nullable":true,"description":"Bairro"},"municipio":{"type":"integer","nullable":true,"description":"Código IBGE"},"email":{"type":"string","nullable":true,"description":"Email"},"ddd":{"type":"string","nullable":true,"description":"DDD"},"telefone":{"type":"string","nullable":true,"description":"Telefone"}}},"representante":{"type":"object","nullable":true,"properties":{"nome":{"type":"string","description":"Nome do representante"},"email":{"type":"string","description":"Email do representante"}}},"itens":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string","description":"Código do produto"},"descricao":{"type":"string","description":"Descrição"},"quantidade":{"type":"number","format":"float","description":"Quantidade"},"status":{"type":"string","description":"Status (OK ou INVALIDO)"},"erros":{"type":"array","items":{"type":"string"},"nullable":true}}}},"cobranca":{"type":"object","nullable":true,"properties":{"numero_fatura":{"type":"string","description":"Número da fatura"},"dt_inicio_pagamento":{"type":"string","format":"date","description":"Data início pagamento"},"forma_pagamento":{"type":"string","nullable":true,"description":"Forma de pagamento"},"tipo_de_receita":{"type":"string","nullable":true,"description":"Tipo de receita"},"plano_de_conta":{"type":"string","nullable":true,"description":"Plano de conta"},"parcelas":{"type":"array","items":{"type":"object","properties":{"numero_titulo":{"type":"string","description":"Número do título"},"valor":{"type":"number","format":"float","description":"Valor"},"data_vencimento":{"type":"string","format":"date","description":"Vencimento"}}}}}},"condicao_de_proposta":{"type":"object","nullable":true,"properties":{"descricao":{"type":"string","description":"Descrição"},"incoterms":{"type":"string","nullable":true,"description":"Incoterms"},"pais_origem":{"type":"string","nullable":true,"description":"País de origem"},"pais_despacho":{"type":"string","nullable":true,"description":"País de despacho"},"pais_aquisicao":{"type":"string","nullable":true,"description":"País de aquisição"},"treinamento":{"type":"string","nullable":true,"description":"Treinamento"},"dt_validade_da_proposta":{"type":"string","format":"date","nullable":true},"garantia":{"type":"string","nullable":true,"description":"Garantia"},"entrega":{"type":"string","nullable":true,"description":"Condições de entrega"},"descricao_moeda":{"type":"string","nullable":true,"description":"Descrição da moeda"}}},"transporte":{"type":"object","nullable":true,"properties":{"quantidade_volumes":{"type":"number","nullable":true},"especie_volumes":{"type":"string","nullable":true},"numeracao_volumes":{"type":"string","nullable":true},"marca_volumes":{"type":"string","nullable":true},"peso_bruto":{"type":"number","format":"float","nullable":true},"peso_liquido":{"type":"number","format":"float","nullable":true}}}}}}}}}},"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Pedido não encontrado"}}}}}}
```

## Atualiza pedido

> Atualiza um pedido existente.\
> Apenas pedidos em digitação podem ser alterados.\
> Aceita os mesmos parâmetros do POST.

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"11. 🛍️ Pedidos de Venda","description":"**Sistema completo de vendas e pedidos**\nGestão do ciclo completo de vendas com integração fiscal.\n**Pipeline comercial:**\n- Orçamentos → Pedidos → NF-e → Faturamento\n- Integração automática com estoque\n- Comissionamento de vendedores\n- Análise de performance comercial"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/pedidos/{id}":{"put":{"summary":"Atualiza pedido","tags":["11. 🛍️ Pedidos de Venda"],"description":"Atualiza um pedido existente.\nApenas pedidos em digitação podem ser alterados.\nAceita os mesmos parâmetros do POST.","parameters":[],"responses":{"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Pedido não encontrado"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","description":"Mesma estrutura do POST - Cria pedido"}}}}}}}}
```

## Excluir pedido

> Exclui um pedido (apenas se não faturado)

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"11. 🛍️ Pedidos de Venda","description":"**Sistema completo de vendas e pedidos**\nGestão do ciclo completo de vendas com integração fiscal.\n**Pipeline comercial:**\n- Orçamentos → Pedidos → NF-e → Faturamento\n- Integração automática com estoque\n- Comissionamento de vendedores\n- Análise de performance comercial"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/pedidos/{id}":{"delete":{"summary":"Excluir pedido","tags":["11. 🛍️ Pedidos de Venda"],"description":"Exclui um pedido (apenas se não faturado)","responses":{"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Pedido não encontrado"}}}}}}
```

## Atualiza status do pedido

> Atualiza apenas o status de um pedido

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"11. 🛍️ Pedidos de Venda","description":"**Sistema completo de vendas e pedidos**\nGestão do ciclo completo de vendas com integração fiscal.\n**Pipeline comercial:**\n- Orçamentos → Pedidos → NF-e → Faturamento\n- Integração automática com estoque\n- Comissionamento de vendedores\n- Análise de performance comercial"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/pedidos/{id}/update_status":{"put":{"summary":"Atualiza status do pedido","tags":["11. 🛍️ Pedidos de Venda"],"description":"Atualiza apenas o status de um pedido","parameters":[{"name":"status","in":"query","description":"Descrição do novo status do pedido","required":true,"schema":{"type":"string"}}],"responses":{"401":{"description":"Não autorizado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://changelog.maino.com.br/api-reference-maino/11.-pedidos-de-venda.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.