Registro Masivo de Comercios

Este servicio permite realizar el registro masivo de comercios patrocinados por un Payment Facilitator mediante el procesamiento de archivos Excel.
Cada comercio puede procesarse como:

INSERT
UPDATE

Según el valor del campo operation.

📶 Ambientes y Buckets S3

Ambiente	Bucket de entrada (IN)	Bucket de salida (OUT)	Observaciones
Desarrollo	`adq-massive-onboarding/payment-facilitator/LUMIO_SAC/IN/`	`adq-massive-onboarding/payment-facilitator/LUMIO_SAC/OUT/`	Nombre de archivo: `OMasivo_*.xlsx`
Producción	Igual que desarrollo	Igual que desarrollo	-

📄 Estructura del Archivo de Entrada (E)

Columna	Tipo	Long.	Descripción	Req
`operation`	String	-	INSERT o UPDATE	✔️
`merchant_code`	String	UUID	Requerido solo en UPDATE	✔️ (solo UPDATE)
`merchant_name`	String	1–25	Nombre del comercio	✔️
`merchant_category_code`	String	4	MCC	✔️
`company_name`	String	hasta 75	Nombre comercial	✔️
`tax_identification_number`	String	11–14	RUC / ID fiscal	✔️
`tax_identification_type`	String	hasta 15	Tipo doc. fiscal	✔️
`tax_identification_country`	String	2	ISO país	✔️
`tax_identification_country_number`	String	3	Código numérico país	✔️
`tax_category`	String	hasta 50	Categoría tributaria	✔️
`phone`	String	9–30	Teléfono	No
`website`	String	hasta 100	Sitio web	No
`country`	String	hasta 10	País	✔️
`country_gov`	String	2	Código ISO	✔️
`city`	String	1–29	Ciudad	✔️
`state`	String	1–200	Departamento	✔️
`postal_code`	String	1–10	Código postal	✔️
`address`	String	1–60	Dirección	✔️
`representative_name`	String	1–140	Contacto legal	✔️
`representative_lastname`	String	1–140	Apellido	✔️
`representative_document_type`	String	-	Tipo doc.	✔️
`representative_document_value`	String	1–12	Número doc.	✔️
`representative_work_position`	String	1–80	Cargo	✔️
`representative_email`	String	-	Email	✔️
`representative_phone`	String	9–30	Teléfono	✔️
`operational_name`	String	1–140	Contacto operativo	✔️
`operational_lastname`	String	1–140	Apellido	✔️
`operational_document_type`	String	-	Tipo doc.	✔️
`operational_document_value`	String	1–12	Número doc.	✔️
`operational_work_position`	String	1–80	Cargo	✔️
`operational_email`	String	-	Email	✔️
`operational_phone`	String	9–30	Teléfono	✔️
`services`	String	JSON	Servicios opcionales	No
`capture`	String	JSON	Configuración captura	No
`payment_methods`	String	JSON	Métodos de pago	✔️
`payment-facilitator-code`	String	UUID	Código PF	✔️

📄 Estructura del Archivo de Salida (S)

Incluye todas las columnas del archivo de entrada, más:

Campo	Descripción
`payment_methods_enabled`	JSON con métodos habilitados
`payment_methods_failed`	JSON de métodos con error
`merchant_code`	UUID asignado
`merchant_alias`	Alias generado
`brand_merchant_identifier`	Identificador interno
`merchant_credentials`	`client_id`, `client_secret` (solo INSERT)
`status`	success / error
`message`	Resultado del procesamiento

⚠️ En UPDATE, no se regeneran credenciales.

📝 Ejemplo de fila (INSERT)

Campo	Valor
operation	INSERT
merchant_name	COMERCIO LUMIO MSV 5
merchant_category_code	5001
company_name	COMERCIO LUMIO TEST
tax_identification_number	20110892999
...	...

Archivo (Descripción)	Ejemplo de archivo
Ejemplo de archivo de entrada	OMasivo_07_072025_20613601000_E.xlsx

📝 Ejemplo de salida (S)

Campo	Valor
status	success
message	Procesado correctamente
merchant_code	53b49178-6d75-4150-a3dd-814308c87b41
merchant_credentials	{client_id, client_secret}
payment_methods_enabled	[...]
payment_methods_failed	[]

Archivo (Descripción)	Ejemplo de archivo
Ejemplo de archivo de salida	OMasivo_07_072025_20613601000_S.xlsx