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

# Proveedores

> Crear y consultar proveedores

**Permiso requerido:** `providers`

<Note>
  Estos endpoints usan el formato de respuesta heredado `{ success, data, message }`.
</Note>

## Listar proveedores de una sucursal

```http theme={null}
GET /providers/branch/{branch_id}
```

Devuelve todos los proveedores activos de la sucursal (sin paginar).

## Crear proveedor

```http theme={null}
POST /providers
```

<Warning>
  El cuerpo debe enviarse **dentro de la clave `data`**.
</Warning>

```json theme={null}
{
  "data": {
    "provider_name": "Distribuidora XYZ",
    "legal_name": "Distribuidora XYZ S.A. de C.V.",
    "register_number": "54321-0",
    "tax_number": "0614-000000-000-0",
    "address": "San Salvador",
    "country_id": "uuid",
    "state_id": "uuid",
    "city_id": "uuid",
    "phone": "2222-3333",
    "email": "ventas@xyz.com",
    "business_type": "legal",
    "branch_id": "uuid"
  }
}
```

| Campo (dentro de `data`) | Requerido | Descripción |
| - | - | - |
| `provider_name` | Sí | Nombre comercial. |
| `address` | Sí | Dirección. |
| `country_id`, `state_id`, `city_id` | Sí | Ubicación. Ver [Catálogos](/docs/api/facturacion/catalogos). |
| `phone` | Sí | Teléfono. |
| `email` | Sí | Correo. |
| `business_type` | Sí | `natural` o `legal`. |
| `branch_id` | Sí | Sucursal. |
| `legal_name` | No | Razón social. |
| `register_number` | No | NRC. |
| `tax_number` | No | NIT. |


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