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

# Criar Fornecedor

> Insere um novo fornecedor (Supplier) no sistema para atrelamento com NFs ou produtos de catálogo.

### Body

<ParamField body="name" type="string" required>Nome Fantasia do fornecedor.</ParamField>
<ParamField body="corporateName" type="string">Opcional. Razão Social (se PJ).</ParamField>
<ParamField body="document" type="string">Opcional. CNPJ ou CPF (aceita com ou sem formatação).</ParamField>
<ParamField body="email" type="string">Endereço de e-mail p/ contato ou faturamento.</ParamField>
<ParamField body="phone" type="string">Telefone de contato.</ParamField>
<ParamField body="active" type="boolean" default="true">Habilita ou desabilita o vendor.</ParamField>

### Response

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "e4b6d4e8-8e6d-41da-abdb-8fc358a9e7f1",
    "name": "Distribuidora Tech",
    "document": "12.345.678/0001-90",
    "createdAt": "2024-02-15T10:00:00.000Z"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml post /suppliers
openapi: 3.0.0
info:
  title: Hub Marketplace API
  description: API for managing marketplace listings and keys
  version: '1.0'
  contact: {}
servers: []
security: []
tags:
  - name: listings
    description: ''
paths:
  /suppliers:
    post:
      tags:
        - Suppliers
      summary: Create a new supplier
      operationId: SuppliersController_create
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSupplierDto'
      responses:
        '201':
          description: ''
components:
  schemas:
    CreateSupplierDto:
      type: object
      properties:
        name:
          type: string
          description: Commercial Name
          example: Fornecedor A
        corporateName:
          type: string
          description: Corporate Name (Razão Social)
          example: Fornecedor A LTDA
        document:
          type: string
          description: Document (CNPJ/CPF)
          example: '12345678000199'
        email:
          type: string
          description: Email
          example: contato@fornecedor.com
        phone:
          type: string
          description: Phone
          example: '11999999999'
        active:
          type: boolean
          description: Active Status
          default: true
      required:
        - name

````