API de compras e entrada

Rotas de pedido de compra, NF de entrada, MDE e vínculo fornecedor-produto.

Base {API}/api. Headers em toda chamada: Authorization, x-company-id, x-filial-id.

Pedido

Ver tabela em pedido de compra. Prefixo /purchase.

Documento de entrada (`/entry-document`)

Método	Rota	Função
`POST`	`/`	cria rascunho
`GET`	`/list/:filialId`	lista
`GET`	`/detail/:id`	detalhe
`GET`	`/audit/:id` e `/audit-history/:id`	auditoria
`PATCH`	`/:id`	edita rascunho
`GET`	`/confirm-preview/:id`	o que a confirmação lançará
`POST`	`/confirm/:id`	confirma (estoque + CP)
`GET`	`/cancel-preview/:id`	preview de cancelamento
`DELETE`	`/:id`	exclui se permitido
`POST`	`/preview-manual`	simula entrada manual

SEFAZ / XML

Método	Rota
`POST`	`/nfe/consultar`
`POST`	`/nfe/consultar-por-chave`
`POST`	`/nfe/download-xml`
`POST`	`/nfe/manifestar`
`POST`	`/nfe/preview` e `/nfe/preview-import`
`POST`	`/nfe/importar` e `/nfe/importar-xml`
`POST`	`/nfe/stage-xml`
`GET`	`/nfe/inbound/:filialId`
`GET`	`/nfe/inbound/pendentes/:filialId`
`GET`	`/nfe/inbound/detail/:id/:filialId`

Contas a pagar da NF

GET /entry-document/contas-pagar/documento/:entryDocumentId
GET /entry-document/contas-pagar/:filialId

Vínculo fornecedor → produto (`FAW02`)

POST /entry-document/product-map/match | link | auto-create
GET /entry-document/product-map/search | next-code | history/:supplierDocument/:filialId
PATCH /entry-document/product-map/:id/conversion-factor
DELETE /entry-document/product-map/:id

curl — preview e confirmação

API=https://api.m3rin.com.br/api
ID=<hashid FAR01>

curl -s -H "Authorization: Bearer $TOKEN" \
  -H "x-company-id: $COMPANY" -H "x-filial-id: $FILIAL" \
  "$API/entry-document/confirm-preview/$ID"

curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  -H "x-company-id: $COMPANY" -H "x-filial-id: $FILIAL" \
  "$API/entry-document/confirm/$ID"

Contrato campo a campo: Swagger autenticado. Esta página descreve o modelo operacional.