Añadir justificante Estimated reading: 2 minutes 52 views Añade justificante de pago tras recibir la notificación de un pago OK de una factura Parámetros de entrada necesario El servicio recibe los siguientes parámetros: Parámetros Tipo de dato Requerido Descripción idCliente Alfanumérico Si Identificador del cliente tokenFactura Alfanumérico Si Identificador generado al crear la factura receipt receipt Si Objeto receipt (ver info) firma Alfanumérico Si Firma generada con los campos y la clave privada El contenido del documento se enviará codificado en Base64 receipt Parámetros Tipo nombreDoc Alfanumérico contenidoDoc Alfanumérico (Contenido del fichero en Base64) mimeType Alfanumérico (Opcional) Parámetros de salida El servicio devolverá un mensaje JSON con los siguientes campos: Campo Valor resultado OK / KO error Error pago (ver tabla) idFactura Ref de factura tokenFactura ID generado para esa factura Dónde:Error: Código de resultado de error que devolverá los valores indicados en la siguiente tabla: Valor Descripción 5 Faltan datos requeridos 8 Identificador erróneo 11 tokenFactura erróneo 13 Error datos justificante El campo firma se compondrá mediante el siguiente proceso. Para ellos se generará una cadena concatenados los siguientes valores: idCliente tokenFactura Clave PrivadaSobre 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)))El resultado de esta función es el valor a enviar en el campo firma Ejemplo de petición Ejecutamos el método addReceipt mediante una invocación POST al servicio en el entorno de test: Url test enviroment https://test.gestionrecibos.online/api/factura/addReceipt Con el siguiente cuerpo: { "idCliente": "bb9e34635fb7", "tokenFactura": "AD1064935F76441A828A9AA874DB", "receipt": { "nombreDoc":"test.pdf", "contenidoDoc":"JVBERi0……", "mimeType":"application/pdf" }, "firma": "7A4C85BD256A92DEDE5EAECE99F6020150EFBA4124DD978D117BB259968ED963" } El campo firma se ha compuesto de la siguiente manera: Creamos la cadena de firma: – BB9E34635FB7BB9E34635FB7C35C7EE710D3 Generamos el hash para esa cadena, lo convertimos a una cadena hexadecimal y lo ponemos en mayúsculas: – 7A4C85BD256A92DEDE5EAECE99F6020150EFBA4124DD978D117BB259968ED963 Respuesta a una petición La petición anterior devolverá una respuesta JSON con el siguiente contenido: Correcta { "resultado":"OK", "error":0, "idPago":"5A12721B", "tokenFactura":"AD1064935F76441A828A9AA874DB6DBF41C97B2C165C4A65AE9382F857CEFEF9" } Con error { "resultado":"KO", "error":0, "idFactura":"F0125", "tokenFactura":"AD1064935F76441A828A9AA874DB6DBF41C97B2C165C4A65AE9382F857CEFEF9" }