---
title: "Vincula o produto às compras"
method: POST
path: "/v1/produtos/{codigo}/vinculos-entrada"
tags: ["Produtos e motor fiscal"]
---

# Vincula o produto às compras

`POST /v1/produtos/{codigo}/vinculos-entrada`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/produtos/{codigo}/vinculos-entrada`
- Auth: HTTP bearer

Três critérios: `gtin` (o GTIN do item na nota de compra), `codigo_fornecedor`
(CNPJ do fornecedor e o código do produto na nota dele) ou `manual` (o id de um
item de nota recebida). A chave de sandbox grava no cadastro dela, lendo as
notas de compra que a empresa já tem.

## Path parameters

- `codigo` string, required

## Query parameters

- `empresa_id` string

## Request body

- object
  - `criterio` 'gtin' | 'codigo_fornecedor' | 'manual', required
  - `gtin` string
  - `cnpj_fornecedor` string
  - `codigo_fornecedor` string
  - `item_nota_fiscal_id` string

## Response `201`

Vinculado.

- VinculoEntradaProduto
  - `id` string
  - `criterio` 'gtin' | 'codigo_fornecedor' | 'manual'
  - `gtin` string, nullable
  - `cnpj_fornecedor` string, nullable
  - `codigo_fornecedor` string, nullable
  - `item_nota_fiscal_id` string, nullable
  - `criado_por` string, nullable
  - `criado_em` string, date-time

## Other responses

- `401`: `nao_autenticado`: chave de API ausente, inválida ou revogada.
- `422`: `validacao`, com `vinculo_invalido` ou `item_nao_encontrado` em `erros`.

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)