> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getjusto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear proveedor

> 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.



## OpenAPI

````yaml post /admin/inventory/providers
openapi: 3.1.0
info:
  title: Justo API
  version: 3.0.0
servers:
  - url: https://api.service.getjusto.com/v3
    description: Production server
security: []
paths:
  /admin/inventory/providers:
    post:
      summary: Crear proveedor
      description: >-
        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.
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/apiInventoryProviderCreateInput'
      responses:
        '200':
          description: The OpenAPI spec
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      _id:
                        type: string
                        description: ID del registro creado, consultado o actualizado.
                      websiteId:
                        type: string
                        description: Marca propietaria del registro.
                      storeId:
                        type: string
                        description: Local propietario, para operaciones por local.
                    description: >-
                      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.
        '400':
          description: Errors
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: 'false'
                  error:
                    type: object
                    properties:
                      error:
                        type: string
                        example: error
                      message:
                        type: string
                        example: The request has an error
components:
  schemas:
    apiInventoryProviderCreateInput:
      type: object
      additionalProperties: false
      properties:
        name:
          type:
            - string
            - 'null'
          description: Nombre del proveedor.
        phone:
          type:
            - string
            - 'null'
          description: Teléfono de contacto, con código de país.
        email:
          type:
            - string
            - 'null'
          description: Correo electrónico de contacto.
        comments:
          type:
            - string
            - 'null'
          description: Comentarios del proveedor.
        legalIdentifier:
          type:
            - string
            - 'null'
          description: Identificador tributario del proveedor.
        identificationType:
          type:
            - string
            - 'null'
          enum:
            - '11'
            - '12'
            - '13'
            - '21'
            - '22'
            - '31'
            - '41'
            - '42'
            - '47'
            - '50'
            - null
          description: Tipo de documento DIAN para proveedores colombianos.
        personType:
          type:
            - string
            - 'null'
          enum:
            - '1'
            - '2'
            - null
          description: 'Tipo de persona: 1 jurídica, 2 natural.'
        addressLine:
          type:
            - string
            - 'null'
          description: Dirección del proveedor.
        city:
          type:
            - string
            - 'null'
          description: Ciudad.
        countrySubentity:
          type:
            - string
            - 'null'
          description: Código de municipio DANE, cuando corresponda.
        taxInfo:
          type:
            - string
            - 'null'
          description: Régimen tributario del proveedor.
      required:
        - name
      example:
        name: Proveedor de alimentos
        email: compras@example.com

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.