# Formato archivo recaudos

El archivo para subir órdenes masivas en Payvalida, es un archivo .csv delimitado por puntos y comas (;), tiene cabeceras de columna que se explican en [Parámetros de cabecera](/guia-del-modulo-comercial/pagos/carga-masiva-de-ordenes/formato-para-subir-ordenes-masivas.md#parametros).

## Ejemplo de plantilla

### :notepad\_spiral: Formato del libro de hoja de cálculo<br>

| nombrePagador | correoPagador         | celularPagador | idCompra    | recurrente | descripcion               | metodoPago | expiracion | valor | iva  | referencia  |
| ------------- | --------------------- | -------------- | ----------- | ---------- | ------------------------- | ---------- | ---------- | ----- | ---- | ----------- |
| John Doe      | <ejemplo@ejemplo.com> | 3163887369     | AC821460606 | true       | cobro de arriendo octubre | efecty     | 30/11/19   | 40000 | 0.19 | 98876325969 |

### :receipt: Formato en texto plano

nombrePagador;correoPagador;celularPagador;idCompra;recurrente;descripcion;metodoPago;expiracion;valor;iva;referencia John Doe;<ejemplo@ejemplo.com>;3163887369;AC821460606;true;cobro de arriendo octubre;efecty;30/11/2019;40000;0;98876325969

## Parámetros de cabecera

### nombrePagador

Nombre de la persona que pagará la orden, puede llevar mayúsculas, minúsculas, espacios en blanco.

### correoPagador

Correo electrónico de la persona que pagará la orden. Debe llevar el formato correcto de cuentas de correo: <ejemplo@correo.com>.

### celularPagador

Número de celular del pagador. No debe llevar espacios o guiones.

### idCompra

Identificador de la compra, puede ser alfanumérico, por ejemplo el número de factura de la venta.

### recurrente

Determina si la orden es recurrente o no. Si la orden es recurrente se debe poner ***true***, si no es recurrente se pone ***false***.

### descripcion

Breve descripción de la orden, se permiten caracteres alfanuméricos. Máximo 50 caracteres, por ejemplo: Cuenta de cobro enero.

### metodoPago

Determina con qué método de pago se deberá hacer la compra. Si la orden se puede pagar con cualquier de los métodos disponibles, se deja el campo vacío, de lo contrario, indica el nombre del método.

* Para conocer los nombres de los métodos de pago, revisa la [siguiente documentación](https://payvalida.gitbook.io/api-cashin/medios-de-pago/colombia).

### expiracion

Es la fecha de vencimiento de la orden. Puede ser máximo de 30 días y mínimo de 24 horas después de creada la orden. El formato de fecha válido es: 30/11/2020.

### valor

El valor de la orden de compra. El formato debe ser plano, sin puntos ni comas decimales.

### iva

Indica el IVA de la orden de compra. Debe ser expresado en decimales. Por ejemplo, si el IVA es del 19%, se debe indicar 0.19 en el campo.

### referencia

Es el número de referencia de la orden. Por defecto y lo más recomendado, es dejarlo vacío para que el sistema asigne una referencia de forma automática. Si se asigna una referencia manualmente, existe la posibilidad de que ya exista con anterioridad.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payvalida.com/guia-del-modulo-comercial/pagos/carga-masiva-de-ordenes/formato-para-subir-ordenes-masivas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.