---
description: >-
  Responsável por criar o Pedido de Compra na base da invoiSys, tornando-o
  imediatamente acessível para o Fornecedor e/ou iniciando o fluxo de vinculação
  com o Documento Fiscal correspondente.
---

# Criar Pedido de Compra

### Endpoint

<mark style="color:green;">`POST`</mark> `https://sandbox-api.invoisys.io/v1/pedido-compra-entrada/enviar`

#### Headers

| Name          | Type   | Description        |
| ------------- | ------ | ------------------ |
| Accept        | string | `application/json` |
| Authorization | string | `bearer <valor>`   |

#### Request Body

<table><thead><tr><th>Name</th><th width="133">Type</th><th>Description</th></tr></thead><tbody><tr><td>numPedidoCompra</td><td>string</td><td>Número do Pedido de Compra</td></tr><tr><td>status</td><td>string</td><td>Status do pedido</td></tr><tr><td>dataVencimento</td><td>datetime</td><td>Data de vencimento do pedido</td></tr><tr><td>codCondPag</td><td>string</td><td>Código da condição de pagamento</td></tr><tr><td>descrCondPag</td><td>string</td><td>Descrição da condição de pagamento</td></tr><tr><td>centroCusto</td><td>string</td><td>Centro de custo associado ao pedido</td></tr><tr><td>obs</td><td>string</td><td>Observações adicionais</td></tr><tr><td>valorTotal</td><td>number</td><td>Valor total do pedido</td></tr><tr><td>fornecedor</td><td>object</td><td>Dados do fornecedor</td></tr><tr><td>fornecedor.cnpj</td><td>string</td><td>CNPJ do fornecedor</td></tr><tr><td>fornecedor.inscricaoEstadual</td><td>string</td><td>Inscrição estadual do fornecedor</td></tr><tr><td>fornecedor.inscricaoMunicipal</td><td>string</td><td>Inscrição municipal do fornecedor</td></tr><tr><td>fornecedor.razaoSocial</td><td>string</td><td>Razão social do fornecedor</td></tr><tr><td>fornecedor.nomeFantasia</td><td>string</td><td>Nome fantasia do fornecedor</td></tr><tr><td>fornecedor.logradouro</td><td>string</td><td>Logradouro do fornecedor</td></tr><tr><td>fornecedor.comlLogradouro</td><td>string</td><td>Complemento do logradouro do fornecedor</td></tr><tr><td>fornecedor.bairro</td><td>string</td><td>Bairro do fornecedor</td></tr><tr><td>fornecedor.cidade</td><td>string</td><td>Cidade do fornecedor</td></tr><tr><td>fornecedor.uf</td><td>string</td><td>Estado (UF) do fornecedor</td></tr><tr><td>fornecedor.cep</td><td>string</td><td>CEP do fornecedor</td></tr><tr><td>fornecedor.pais</td><td>string</td><td>País do fornecedor</td></tr><tr><td>fornecedor.responsavel</td><td>object</td><td>Dados do responsável pelo fornecedor</td></tr><tr><td>fornecedor.responsavel.nome</td><td>string</td><td>Nome do responsável pelo fornecedor</td></tr><tr><td>fornecedor.responsavel.telefone</td><td>string</td><td>Telefone do responsável pelo fornecedor</td></tr><tr><td>fornecedor.responsavel.email</td><td>string</td><td>E-mail do responsável pelo fornecedor</td></tr><tr><td>fornecedor.responsavel.contato</td><td>string</td><td>Informações de contato adicionais do responsável</td></tr><tr><td>contratante</td><td>object</td><td>Dados do contratante</td></tr><tr><td>contratante.cnpj</td><td>string</td><td>CNPJ do contratante</td></tr><tr><td>contratante.inscricaoEstadual</td><td>string</td><td>Inscrição estadual do contratante</td></tr><tr><td>contratante.inscricaoMunicipal</td><td>string</td><td>Inscrição municipal do contratante</td></tr><tr><td>contratante.razaoSocial</td><td>string</td><td>Razão social do contratante</td></tr><tr><td>contratante.nomeFantasia</td><td>string</td><td>Nome fantasia do contratante</td></tr><tr><td>contratante.logradouro</td><td>string</td><td>Logradouro do contratante</td></tr><tr><td>contratante.complLogradouro</td><td>string</td><td>Complemento do logradouro do contratante</td></tr><tr><td>contratante.bairro</td><td>string</td><td>Bairro do contratante</td></tr><tr><td>contratante.cidade</td><td>string</td><td>Cidade do contratante</td></tr><tr><td>contratante.uf</td><td>string</td><td>Estado (UF) do contratante</td></tr><tr><td>contratante.cep</td><td>string</td><td>CEP do contratante</td></tr><tr><td>contratante.pais</td><td>string</td><td>País do contratante</td></tr><tr><td>contratante.responsavel</td><td>object</td><td>Dados do responsável pelo contratante</td></tr><tr><td>contratante.responsavel.nome</td><td>string</td><td>Nome do responsável pelo contratante</td></tr><tr><td>contratante.responsavel.telefone</td><td>string</td><td>Telefone do responsável pelo contratante</td></tr><tr><td>contratante.responsavel.email</td><td>string</td><td>E-mail do responsável pelo contratante</td></tr><tr><td>contratante.responsavel.contato</td><td>string</td><td>Informações de contato adicionais do responsável</td></tr><tr><td>items</td><td>array</td><td>Lista de itens do pedido</td></tr><tr><td>items.nItem</td><td>string</td><td>Número do item no pedido</td></tr><tr><td>items.descricao</td><td>string</td><td>Descrição do item</td></tr><tr><td>items.codigo</td><td>string</td><td>Código do item</td></tr><tr><td>items.gtin</td><td>number</td><td>Código GTIN do item</td></tr><tr><td>items.quantidade</td><td>number</td><td>Quantidade do item</td></tr><tr><td>items.unidadeMedida</td><td>string</td><td>Unidade de medida do item</td></tr><tr><td>items.precoUnitario</td><td>number</td><td>Preço unitário do item</td></tr><tr><td>items.desconto</td><td>number</td><td>Desconto aplicado ao item</td></tr><tr><td>items.total</td><td>number</td><td>Valor total do item após desconto</td></tr><tr><td>items.observacao</td><td>string</td><td>Observação específica sobre o item</td></tr></tbody></table>

#### Response

{% tabs %}
{% tab title="201 - Sucesso" %}
```csharp
{
  "id": "379056917238927361",
  "mensagens": [
    "Pedido de compra inserido com sucesso."
  ]
}
```
{% endtab %}

{% tab title="400 - Erro por validação dos campos" %}
```csharp
{
  "id": "",
  "mensagens": [
    "Status é obrigatório."
  ]
}
```
{% endtab %}
{% endtabs %}

{% hint style="info" %}
#### Swagger

[Você pode acessar nossa API e realizar testes diretamente na nossa plataforma Swagger!](https://sandbox-api.invoisys.io/swagger/index.html)
{% endhint %}

## Endpoints Relacionados 🎈

* [Editar Pedido de Compra](editar-pedido-de-compra)
* [Consultar Pedido de Compra](consultar-pedido-de-compra)
