> For the complete documentation index, see [llms.txt](https://developers.tusfacturas.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.tusfacturas.app/recibos-de-cobro-y-ordenes-de-pago/api-factura-electronica-afip-or-ingresar-pago.md). # Ingresar pago a un comprobante emitido {% hint style="info" %} Datos a tener en cuenta * Los cobros que informes, se usan solo para la gestión interna de nuestra plataforma y tu cliente no lo verá reflejado en el PDF del comprobante que emitiste, ya que el único objetivo que tiene éste bloque es nutrir la cuenta corriente de tu cliente, con el pago realizado. * **NO** podrás enviar los siguientes medios de pago: "cheques" y ni "retenciones". * Se realizara una validación del total que se indique, contra la sumatoria de los medios de pago detallados * El total de los pagos **NO** debe superar el importe total del comprobante, pero si puede ser inferior, para indicar que el comprobante recibió un pago parcial. {% endhint %} ### Ingresar pagos a un comprobante emitido `POST` `https://www.tusfacturas.app/app/api/v2/facturacion/``pagar` 💡 Cada vez que utilices este método, se contará como un request en tu suscripción. Los requests se cuentan por cada método que uses. #### Request Body | Name | Type | Description | | ----------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | apitoken | String | Tus credenciales de acceso | | apikey | String | Tus credenciales de acceso | | usertoken | String | Tus credenciales de acceso | | comprobante | object |

Un objeto compuesto de los siguientes atributos:

tipo: Campo alfanumérico. Longitud máx: 50 caracteres, conteniendo el tipo de comprobante a consultar. Ej: FACTURA A

operacion : Campo alfanumérico. Longitud máx: 1 carácter. Valores permitidos (V o C) ya sea para ventas o compras.

punto\_venta Campo númerico para indicar el número del punto de venta.

numero : Campo numérico. Longitud máx: 8. Indica el número del comprobante a consultar.

pagos: Bloque según estructura que se detalla a continuación

| ### Ejemplo del JSON completo a enviar ``` { "apitoken": "xxxx", "apikey": xxxx, "usertoken": "xxxx", "comprobante": { "tipo": "FACTURA A", "operacion": "V", "punto_venta": "00010", "numero": "00000109", "pagos" : { "formas_pago" : [ {"descripcion" : "VISA", "importe" : 200}, {"descripcion" : "MercadoPago", "importe" : 1000} ], "total": 1200 } } } ``` ### Estructura del objeto "comprobante | Nombre del campo | Tipo de dato | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | tipo |

Campo numérico según tabla de referencia de Tipos de comprobantes(\*\*\*).

Ejemplo: FACTURA B

| | punto\_venta |

Campo numérico entero.

Longitud máxima 5 dígitos.

Ejemplo: 3

| | numero |

Campo numérico entero.

Longitud máxima 8 digitos.

| | operacion |

Campo alfanumérico.

Longitud 1 carácter.

Indica si envía una factura de venta (V) o de compra (C).

Valores Permitidos: V

| | pagos | Según estructura que se detalla a continuación | ``` { "comprobante": { "tipo": "FACTURA A", "operacion": "V", "punto_venta": "00010", "numero": "00000109", "pagos" : { .... } } } ``` ### Estructura del objeto pagos | nombre del campo | Requerido | Detalle | | ---------------- | --------- | -------------------------------------------------------------------------------------------------------- | | formas\_pago | SI | array con multiples items, según estructura que se detalla a continuación | | total | SI |

Campo numérico con 2 decimales. separador de decimales: punto
Ejemplo: 645.67

| Información de los campos que componen el **array de pagos > formas\_pago** | nombre del campo | Requerido | Detalle | | ---------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | descripcion | SI |

El nombre del medio de pago elegido para cancelar el comprobante. 255 caracteres max.

En caso que el medio de pago, no exista en nuestra plataforma, será dado de alta automáticamente.

| | importe | SI |

Campo numérico con 2 decimales. separador de decimales: punto
Ejemplo: 645.67

| Ejemplo del JSON a enviar. {% code title="JSON" %} ``` comprobante: { .... "pagos" : { "formas_pago" : [ {"descripcion" : "VISA DB", "importe" : 0.6}, {"descripcion" : "MercadoPago", "importe" : 50} ], "total": 50.6 }, } ``` {% endcode %} ### Ejemplo del JSON completo a enviar ``` { "apitoken": "xxxx", "apikey": xxxx, "usertoken": "xxx", "comprobante": { "tipo": "FACTURA A", "operacion": "V", "punto_venta": "00010", "numero": "00000109", "pagos" : { "formas_pago" : [ {"descripcion" : "VISA", "importe" : 200}, {"descripcion" : "MercadoPago", "importe" : 1000} ], "total": 1200 } } } ``` ### Respuesta JSON ``` { "error": "S", "errores": ["Error 2"], } ``` En caso de éxito: ``` { "error": "N", "errores": [], } ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://developers.tusfacturas.app/recibos-de-cobro-y-ordenes-de-pago/api-factura-electronica-afip-or-ingresar-pago.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.