Clientes

Administra tu base de clientes.

Entidad base que representa a sus clientes/compradores. Debe cargarse primero ya que otras entidades dependen de ella.

Endpoint

POST /full-csv-integration/upload-customers

Campo de Formulario: customersFile

Campos Requeridos

Campo	Tipo	Descripción	Validaciones
`nit`	String	Número de identificación tributaria	No puede estar vacío
`erp_customer_id`	String	ID único del cliente en su ERP	No puede estar vacío
`company_name`	String	Razón social o nombre de la empresa	No puede estar vacío

Campos Opcionales

Campo	Tipo	Descripción	Por Defecto
`email`	String	Correo electrónico de la empresa	null
`city_name`	String	Ciudad sede	null
`state_name`	String	Departamento/Provincia	null
`postal_code`	String	Código postal	null
`country_code`	String	Código de país	null
`credit_limit`	Float	Cupo de crédito actual	null
`current_term`	Integer	Plazo de pago en días	null
`allow_collection`	Boolean	Permitir campañas de cobranza automática	`1` (true)
`advance_balance`	Float	Saldo a favor del cliente	null
`erp_branch_id`	String	ID de sucursal en ERP	null
`branch_name`	String	Nombre de la sucursal	null

Ejemplo CSV

nit,erp_customer_id,company_name,email,city_name,state_name,credit_limit,current_term,allow_collection
123456789-1,CUST001,ABC Company Inc.,contact@abc.com,Bogotá,Cundinamarca,1000000.00,30,1
987654321-2,CUST002,XYZ Corporation Ltd.,info@xyz.com,Medellín,Antioquia,500000.00,15,1