> For the complete documentation index, see [llms.txt](https://changelog.maino.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.maino.com.br/api-reference-maino/10.-pedidos-de-venda.md).

# 10. 🛍️ 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":"10. 🛍️ 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":["10. 🛍️ 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":"10. 🛍️ 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":["10. 🛍️ 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":"10. 🛍️ 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":["10. 🛍️ 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":"10. 🛍️ 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":["10. 🛍️ 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":"10. 🛍️ 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":["10. 🛍️ 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":"10. 🛍️ 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":["10. 🛍️ 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":"10. 🛍️ 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":["10. 🛍️ 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":"10. 🛍️ 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":["10. 🛍️ 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":"10. 🛍️ 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":["10. 🛍️ 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"}}}}}}}}}}}
```