---
title: "Crear proveedor"
method: POST
path: "/admin/inventory/providers"
---

# Crear proveedor

`POST /admin/inventory/providers`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/admin/inventory/providers`
- Auth: none declared

Crea el registro mediante la misma operación que el administrador de inventario. Requiere autorización admin y un usuario conectado; un token de integración sin usuario responde userRequired. Se aplican los mismos permisos y validaciones del formulario de inventario.

## Request body

- ApiInventoryProviderCreateInput
  - `name` string, nullable, required: Nombre del proveedor.
  - `phone` string, nullable: Teléfono de contacto, con código de país.
  - `email` string, nullable: Correo electrónico de contacto.
  - `comments` string, nullable: Comentarios del proveedor.
  - `legalIdentifier` string, nullable: Identificador tributario del proveedor.
  - `identificationType` '11' | '12' | '13' | '21' | '22' | '31' | '41' | '42' | '47' | '50' | 'null', nullable: Tipo de documento DIAN para proveedores colombianos.
  - `personType` '1' | '2' | 'null', nullable: Tipo de persona: 1 jurídica, 2 natural.
  - `addressLine` string, nullable: Dirección del proveedor.
  - `city` string, nullable: Ciudad.
  - `countrySubentity` string, nullable: Código de municipio DANE, cuando corresponda.
  - `taxInfo` string, nullable: Régimen tributario del proveedor.

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` object: Registro de inventario con los campos de su operación, como estado, ingredientes, cantidades y costos. Las fechas se devuelven en el formato del servicio Tabs.
    - `_id` string: ID del registro creado, consultado o actualizado.
    - `websiteId` string: Marca propietaria del registro.
    - `storeId` string: Local propietario, para operaciones por local.

## Other responses

- `400`: Errors

## Changes

- **2026-10-31** `4ad06bd631ce`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/admin/inventory/providers/post.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)