Proveedores - FileXpress

Permiso requerido: providers

Estos endpoints usan el formato de respuesta heredado { success, data, message }.

Listar proveedores de una sucursal

GET /providers/branch/{branch_id}

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

Crear proveedor

POST /providers

El cuerpo debe enviarse dentro de la clave data.

{
  "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.
`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.