> ## Documentation Index > Fetch the complete documentation index at: https://docs.agulhao.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Cria um novo pedido > Cria um novo pedido no sistema Agulhão ## OpenAPI ````yaml /api-bitrix/openapi.yaml post /pedidos openapi: 3.1.0 info: title: Agulhão API - Bitrix24 description: API do sistema Agulhão para integração com Bitrix24. contact: email: contato@softros.com.br url: https://agulhao.com.br version: 1.0.1 servers: - url: https://api-integracoes.agulhao.com.br description: Produção security: [] tags: - name: filiais-bt - name: pessoas-bt - name: produtos-bt - name: pedidos-bt - name: tipos-lancamento externalDocs: description: Mais sobre a API url: https://docs.agulhao.com.br/api paths: /pedidos: post: tags: - pedidos-bt summary: Cria um novo pedido description: Cria um novo pedido no sistema Agulhão operationId: postPedidos requestBody: required: true description: Dados do pedido a ser criado content: application/json: schema: type: object properties: id: type: number description: >- ID do pedido no Agulhão (se não existir ou não for encontrado a partir do idExterno, será gerado um novo) idExterno: type: string description: ID do pedido na integração (seu id) descontoDinheiro: type: number format: float description: Desconto em dinheiro aplicado ao pedido example: 10 valorFrete: type: number format: float description: Valor do frete example: 15 observacoes: type: string description: Observações do pedido example: Observações do pedido valorOutros: type: number format: float description: Valor de outros custos adicionais do pedido example: 5 cancelado: type: boolean description: Indica se o pedido foi cancelado example: false tipoPedido: type: string description: Tipo do pedido filialCod: type: string description: Código da filial onde o pedido foi realizado tipoFrete: type: string description: Tipo de frete do pedido dataEmissao: type: string format: date-time description: Data de emissão do pedido example: '2025-01-01T00:00:00' dataFechamento: type: string format: date-time description: Data de fechamento do pedido example: '2025-01-02T00:00:00' guiaCod: type: number description: Código do guia associado ao pedido example: 1 vendedorCod: type: number description: Código do vendedor associado ao pedido example: 1 transportadoraCod: type: number description: Código da transportadora associada ao pedido example: 1 gerenteProjetoCod: type: number description: Código do gerente de projeto associado ao pedido example: 1 responsavelCod: type: number description: Código do responsável pelo pedido example: 1 tipoLancamentoCod: type: number description: Código do tipo de lançamento do pedido example: 1 cliente: type: object properties: pessoaCod: type: number description: Código da pessoa/cliente (se ja existir no agulhao) example: 1 documento: type: string description: CNPJ ou CPF do cliente example: '00000000000000' telefone: type: string description: Telefone do cliente example: '1112345678' email: type: string description: E-mail do cliente example: contato@cliente.com nome: type: string description: Nome do cliente example: Nome do Cliente logradouro: type: string description: Logradouro do endereço do cliente example: Avenida Paulista complemento: type: string description: Complemento do endereço do cliente example: Apto 101 numero: type: string description: Número do endereço do cliente example: '1000' bairro: type: string description: Bairro do endereço do cliente example: Bela Vista cidade: type: string description: Nome da cidade do endereço do cliente example: São Paulo uf: type: string description: Sigla da unidade federativa do endereço do cliente example: SP ibgeCidade: type: string description: Código IBGE da cidade do endereço do cliente example: '3550308' entrega: type: object properties: logradouro: type: string description: Logradouro do endereço de entrega example: Avenida Paulista complemento: type: string description: Complemento do endereço de entrega example: Apto 101 numero: type: string description: Número do endereço de entrega example: '1000' bairro: type: string description: Bairro do endereço de entrega example: Bela Vista cidade: type: string description: Nome da cidade do endereço de entrega example: São Paulo uf: type: string description: Sigla da unidade federativa do endereço de entrega example: SP ibgeCidade: type: string description: Código IBGE da cidade do endereço de entrega example: '3550308' produtos: type: array items: type: object required: - id - idGrade - quantidade - valorUnitario properties: id: type: string description: Identificador único do produto example: '1' idGrade: type: string description: Identificador único da grade do produto example: '1' quantidade: type: number format: integer description: Quantidade do produto no pedido example: 1 valorUnitario: type: number format: float description: Valor unitário do produto no pedido example: 100 pagamentos: type: array items: type: object required: - tipoLancamentoCod - valor - dataVencimento properties: valor: type: number format: float description: Valor do pagamento example: 100 pago: type: boolean description: Indica se o pagamento foi realizado example: false gateway: type: string description: Gateway de pagamento utilizado example: MERCADO PAGO examples: contrato: summary: Contrato description: >- Contratos no Agulhão são tratados como pedidos e identificados pelo tipo de lançamento value: filialCod: 1 tipoLancamentoCod: 5 vendedorCod: 3530 responsavelCod: 221 gerenteProjetoCod: 221 dataEmissao: '2025-06-25' dataFechamento: '2025-06-25' observacoes: Contrato de teste cliente: pessoaCod: 3521 produtos: - id: '1' idGrade: '1' quantidade: 1 valorUnitario: 100 comCadastroDeCliente: summary: Com cadastro de cliente description: >- Exemplo de pedido com cadastro de cliente (se o cliente não existir, será criado um novo cadastro no sistema) value: idExterno: 4560a17a-ea59-4c4b-a2a4-78610dd04d4a descontoDinheiro: 0 valorFrete: 15 observacoes: Pedido de teste com cadastro de cliente valorOutros: 0 cancelado: false cliente: documento: '00000000000000' nome: Nome do Cliente telefone: '1112345678' email: contato@cliente.com logradouro: Avenida Paulista complemento: Apto 101 numero: '1000' cep: '01000000' bairro: Bela Vista produtos: - id: 5598 idGrade: 1 quantidade: 1 valorUnitario: 79.9 pagamentos: - valor: 79.9 pago: true gateway: PAGSEGURO comPagamento: summary: Básico com pagamento description: >- Exemplo de pedido com pagamento (Se pago for "false" é considerado como um pré pagamento) value: observacoes: Pedido de teste com pagamento cliente: pessoaCod: 1 produtos: - id: '1' idGrade: '1' quantidade: 2 valorUnitario: 50 pagamentos: - valor: 100 pago: true gateway: MERCADO PAGO semPagamento: summary: Básico sem pagamento value: observacoes: Pedido de teste sem pagamento cliente: pessoaCod: 1 produtos: - id: '1' idGrade: '1' quantidade: 2 valorUnitario: 50 responses: '201': description: Pedido criado com sucesso content: application/json: schema: type: object properties: idAgulhao: type: string description: Identificador único do pedido criado no Agulhão example: '1' idExterno: type: string description: Identificador único do pedido na integração (seu id) example: 4560a17a-ea59-4c4b-a2a4-78610dd04d4a '400': description: >- Parâmetros inválidos ou faltando informações necessárias para criar o pedido. content: application/json: schema: type: object properties: mensagem: type: string example: Parâmetros inválidos. Verifique os dados enviados. tecnico: type: string example: Erro ao validar os dados do pedido. '500': description: Erro interno do servidor ao tentar criar o pedido. content: application/json: schema: type: object properties: mensagem: type: string example: Erro ao criar o pedido. tecnico: type: string example: Erro ao salvar o pedido no banco de dados. security: - chaveApi: [] components: securitySchemes: chaveApi: description: Chave da API gerada no agulhão type: apiKey name: x-api-key in: header ````