> For the complete documentation index, see [llms.txt](https://integracao.gitbook.io/invoisys/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integracao.gitbook.io/invoisys/endpoints/pedidos-e-transporte/pedido-de-compra/consultar-pedido-de-compra.md).

# Consultar Pedido de Compra

Responsável por consultar o Pedido de Compra na base da invoiSys, assegurando a coleta precisa das informações de vinculação com o Documento Fiscal Eletrônico (DF-e) associado.

### Endpoint

<mark style="color:blue;">`GET`</mark> `https://sandbox-api.invoisys.io/v1/pedido-compra-entrada/obter-pedido/{numPedidoCompra}/{CNPJContratante}`

<mark style="color:blue;">`GET`</mark> `https://sandbox-api.invoisys.io/v1/pedido-compra-entrada/obter-pedido/{id}`

#### Headers

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

#### Path Parameters por Número de Pedido de Compra e CNPJ Contratante

<table><thead><tr><th width="230">Name</th><th width="121">Type</th><th>Description</th></tr></thead><tbody><tr><td>NumPedidoCompra</td><td>integer</td><td>Número do Pedido de Compra</td></tr><tr><td>CNPJContratante</td><td>integer</td><td>CNPJ do contratante do Pedido de Compra</td></tr></tbody></table>

#### Path Parameter por ID

<table><thead><tr><th width="231">Name</th><th width="109">Type</th><th>Description</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>ID invoiSys do Pedido de Compra</td></tr></tbody></table>

#### Response

{% tabs %}
{% tab title="200 - Sucesso" %}

```csharp
	
{
  "docData": {
    "numPedidoCompra": "HI32054",
    "dataEmissao": "2024-06-07T14:21:45.034Z",
    "dataVencimento": "0001-01-01T00:00:00Z",
    "codCondPag": "",
    "descrCondPag": "",
    "centroCusto": "",
    "obs": "",
    "valorTotal": 4070.08,
    "fornecedor": {
      "cnpj": "17921427000125",
      "inscricaoEstadual": "",
      "inscricaoMunicipal": "",
      "razaoSocial": "TRANSPORTADORA TESTE",
      "nomeFantasia": "",
      "logradouro": "AVENIDA DEZ",
      "complLogradouro": null,
      "bairro": "",
      "cidade": "FRONTEIRA",
      "uf": "MG",
      "cep": "38230000",
      "pais": null,
      "responsavel": {
        "nome": "",
        "telefone": "",
        "email": "",
        "contato": null
      }
    },
    "contratante": {
      "cnpj": "17921427000125",
      "inscricaoEstadual": "",
      "inscricaoMunicipal": "",
      "razaoSocial": "CONTRATANTE TESTE",
      "nomeFantasia": "",
      "logradouro": "CONTRATANTE TESTE",
      "complLogradouro": null,
      "bairro": "",
      "cidade": "RESENDE",
      "uf": "RJ",
      "cep": "27534010",
      "pais": null,
      "responsavel": {
        "nome": "",
        "telefone": "",
        "email": "",
        "contato": null
      }
    }
  },
  "docStatus": {
    "status": "VD",
    "statusVinculoItem": null
  },
  "docControl": {
    "origem": "",
    "canal": "",
    "documentosVinculados": [
      {
        "obsPag": null,
        "tipoDocOrigem": "nfe",
        "idDocOrigem": "1111111111111",
        "valor": 3226,
        "numero": "421690",
        "statusVinculoItem": null,
        "dataVinculo": "2024-06-12T18:22:31.132Z",
        "dataEmissao": "2024-05-24T17:42:44Z",
        "statusVinculo": "Dados Divergentes",
        "statusCompra": null,
        "dataProcessamento": "0001-01-01T00:00:00Z",
        "dataPagamentoPrevisto": "0001-01-01T00:00:00Z",
        "dataPagamentoRealizado": "0001-01-01T00:00:00Z"
      },
      {
        "obsPag": null,
        "tipoDocOrigem": "nfse",
        "idDocOrigem": "22222222222222222",
        "valor": 1370,
        "numero": "13068",
        "statusVinculoItem": null,
        "dataVinculo": "2024-06-12T18:26:29.951Z",
        "dataEmissao": "2024-01-30T20:30:24Z",
        "statusVinculo": "Dados Divergentes",
        "statusCompra": null,
        "dataProcessamento": "0001-01-01T00:00:00Z",
        "dataPagamentoPrevisto": "0001-01-01T00:00:00Z",
        "dataPagamentoRealizado": "0001-01-01T00:00:00Z"
      }
    ],
    "items": [
      {
        "nItem": "1.000",
        "descricao": "FRETE 12% ICMS",
        "codigo": "61578",
        "gtin": 0,
        "quantidade": 4070.08,
        "unidadeMedida": "UN",
        "precoUnitario": 1,
        "desconto": 0,
        "total": 4070.08,
        "observacao": null
      }
    ]
  }
}
```

{% endtab %}

{% tab title="404 - Pedido de Compra inexistente" %}

```csharp
{
  "mensagens": [
    "Pedido de Compra HI320545 inexistente na base de dados para o CNPJ do contratante 33.856.394/0013-77."
  ]
}
```

{% endtab %}

{% tab title="400 - Má formatação" %}

```csharp
{
  "mensagens": [
    "O campo 'CNPJContratante' deve possuir 14 caracteres"
  ]
}
```

{% 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 🎈

* [Criar Pedido de Compra](/invoisys/endpoints/pedidos-e-transporte/pedido-de-compra/criar-pedido-de-compra.md)
* [Editar Pedido de Compra](/invoisys/endpoints/pedidos-e-transporte/pedido-de-compra/editar-pedido-de-compra.md)