Clientes y Proveedores

Gestión integral del directorio comercial. Es fundamental registrar correctamente a los receptores para la validación de documentos ante el Ministerio de Hacienda.

POST /external/customers

Crea un nuevo cliente o actualiza uno existente basado en su número de documento o NIT.

Campos Requeridos

customer_name (Requerido)

address (Requerido)

country_id / state_id / city_id

activity_id (Actividad Económica MH)

phone / email

business_type / branch_id

Parámetros Completos

Campo	Tipo	Descripción
customer_name	String	Nombre comercial o nombre de la persona.
legal_name	String	Razón social (Requerido para `natural` y `legal`).
business_type	String	Valores: `non-business` (Consumidor), `natural` (Persona Natural), `legal` (Sociedad).
document_type	String	Valores: `13` (DUI), `36` (NIT), `03` (Passport), `02` (Residencia), `37` (Other).
document_number	String	Número de DUI, Pasaporte o Carnet de Residencia.
tax_number	String	Número de NIT (Requerido para tipos `natural` y `legal`).
register_number	String	Número de registro de IVA (NRC).
business_size	String	Tamaño de empresa: `small, medium, large`.
country_id	UUID	ID obtenido del catálogo de países (default El Salvador).
state_id	UUID	ID obtenido del catálogo de estados/departamento.
city_id	UUID	ID obtenido del catálogo de ciudades.
activity_id	UUID	ID obtenido del catálogo de actividades comerciales.
address	String	Dirección física detallada.
email	String	Correo para envío de DTE.
phone	String	Teléfono de contacto.
branch_id	UUID	ID de la sucursal a la que pertenece el cliente.

GET /external/customers/branch/{id}

Obtén el listado de clientes registrados en una sucursal específica.

HTTP 200

{
  "customer_name": "Nombre Comercial",
  "legal_name": "Razón Social Completa",
  "business_type": "legal",
  "document_type": "36",
  "document_number": "0614-000000-000-0",
  "tax_number": "123456-7",
  "register_number": "98765-4",
  "address": "San Salvador, El Salvador",
  "country_id": "uuid-sv",
  "state_id": "uuid-ss",
  "city_id": "uuid-capital",
  "activity_id": "uuid-actividad",
  "phone": "2222-2222",
  "email": "info@empresa.com",
  "branch_id": "uuid-sucursal"
}