Documentación Collectar

Documentación Collectar

Documentación técnica de integración

Consultar el estado de la factura

Estimated reading: 2 minutes 124 views

Este método sirve para recuperar el estado de una factura desde un sistema externo

Parámetros de entrada necesarios


El servicio recibe los siguientes parámetros en formado JSON

Parámetros de salida


El servicio devolverá un mensaje en formato JSON con los siguientes campos:

Dónde:
-Error: Código de resultado de error que devolverá los valores indicados en la siguiente tabla:
errorFactura

Posibles valores del campo:

estadoFactura

El campo firma se compondrá mediante el siguiente proceso.
Para ellos se generará una cadena concatenados los siguientes valores:

idCliente

tokenFactura

Clave Privada

Sobre esta cadena, aplicaremos una función SHA 256 y el resultado será codificado en una cadena hexadecimal (en Mayúsculas):

firma = upper(hex(sha256(cadena de firma)))

Ejemplo de petición

Ejecutamos el método checkstatus mediante una invocación POST al servicio en el entorno de test:



Con el siguiente cuerpo:

				
					{ 
 "idCliente": "bb9e34635fb7", 
 "tokenFactura": "5A127216B9CB4DC2986399C0BFF5A8", 
 "firma": "C3E7E0D366FE49B87BEE81AFCEDE2914FA4B0AB3C75BB860D73353FF89588D5D"
}
				
			

El campo firma se ha compuesto de la siguiente manera:



Creamos la cadena de firma:
BB9E34635FB75A127216B9CB4DC2986399C0BFF5A8C35C7EE710D3



Generamos el hash para esa cadena, lo convertimos a una cadena hexadecimal y lo ponemos
en mayúsculas:
C3E7E0D366FE49B87BEE81AFCEDE2914FA4B0AB3C75BB860D73353FF89588D5D

Respuesta a una petición
La petición anterior devolverá una respuesta JSON con el siguiente contenido:

Correcta
				
					{ 
 "numFactura": "F0125", 
 "tokenFactura":
 "5A127216B9CB4DC298399C0BFF5A83201A3B713099F7458593FE1B6E42B84E7B",
 "estado": "1001", 
 "fechaUltimoCambio": "2020-01-12 01:10:58", 
 "error": 0 
}

				
			

Con error 

				
					{ 
 "error": 4 (Código de error correspondiente)
 "idFactura": "F0125", 
 "tokenFactura":
 "5A127216B9CB4DC298399C0BFF5A83201A3B713099F7458593FE1B6E42B84E7B" 
}
				
			
CONTENTS
en_GBEnglish (UK)