Ingresar pago a un comprobante emitido

TusFacturasAPP: ¡Más que facturas! Gestiona tus cobros, actualiza saldos y optimiza tu flujo de caja con nuestra API para generar recibos de cobro.

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.

Datos a tener en cuenta

  • 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.

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

NameTypeDescription

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

Ejemplos de las respuestas JSON en caso de éxito o error

{
	"error": "N",
	"errores": [""],
}

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 campoTipo 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 campoRequeridoDetalle

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 campoRequeridoDetalle

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.

JSON
comprobante: {
   .... 
   "pagos" : 
   {
	"formas_pago" : [ 
			{"descripcion" : "VISA DB", "importe" : 0.6},
			{"descripcion" : "MercadoPago", "importe" : 50}
			], 
	"total": 50.6
   }, 
 }

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
			}
	}
}
 

Last updated