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.

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.

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.

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

Respuesta JSON

{
	"error": "S",
	"errores":  ["Error 2"],
}

En caso de éxito:

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