Emisión de echeq

Emisión de Echeqs:

Este endpoint permite la emisión de un ECHEQ por parte de un cliente. La emisión requiere de validaciones de token y cabeceras de autorización, y la respuesta depende de las condiciones del request y los recursos disponibles.

• Permite la emisión de Echeqs al día o diferido (hasta 360 días).
• Permite emitir un Echeq mediante un CMC7 o bien eligiendo un Echeq al azar.
• Permite emitir Echeqs a la orden y no a la orden.
• El servicio brinda la posibilidad de enviarle un mail al beneficiario del Echeq.
• Si al invocar la API, los parámetros fueron enviados correctamente, el Echeq iniciará el proceso de emisión pasado un lapso de tiempo.
• Es recomendable consultar el estado del lote que realizó la emisión del Echeq (API Consulta lote de Echeqs por ID) pasados 5 minutos de la emisión, para conocer el estado de la solicitud de emisión.

Pre-requisitos para emisión de Echeqs

• Tener al menos una cuenta origen habilitada para realizar emisión de Echeqs. Se debe comunicar con el asesor comercial asignado para conocer este proceso.
• Las cuentas para operar tienen que ser Cuenta Corriente (CC) en pesos argentinos.
• Tener al menos una Echequera con al menos un Echeq disponible del tipo que se va a emitir (Diferido o Al Día), se puede consultar en (API Consulta cantidad de echeqs disponibles por cuenta).
• Conocer los firmantes del Echeq. Los mismos deben ser configurados en el portal de Ebanking. Se debe comunicar con el asesor comercial asignado para conocer este proceso.
• Activar las opciones necesarias en el Ebanking (se muestra a continuación).

Configuraciones requeridas desde Ebanking

IMPORTANTE: En caso de presentar algún problema con el uso de Ebanking en relación a las configuraciones mencionadas en esta documentación, deberá comunicarse con su oficial/responsable comercial para que le brinde soporte sobre estas configuraciones. Todas las capturas son desde un ambiente de pruebas de Ebanking.

1. Activar las opciones necesarias para Echeqs

2. Sección de Emisión

   Permite seleccionar que cuentas pertenecientes a la empresa van a ser habilitadas para Emitir Echeqs. Para poder consumir el servicio API de emisión [POST]:/v1/echeqs debe tener en cuenta que debe tener habilitadas las cuentas en este punto.

3. Asignación de CMC7

   Al estar habilitada esta opción, se deberá informar en el campo CMC7 en el body request (detallado más abajo) del Echeq a utilizar. (Los CMC7 disponibles para utilizar con esta opción, deben ser visualizados desde Ebanking)

4. Sección E-Chequeras

Deberá tener una cuenta habilitada con Echeqs para poder hacer emisiones. Estos Echeqs se diferencian por Echeqs al día o Echeqs diferidos.

Servicio opcional de envío de mail al beneficiario:

El servicio brinda la posibilidad de enviarle un mail al beneficiario del Echeq. Para ello deberá completar los campos del body request “notification”. En caso de enviarlo el beneficiario recibirá un mail como este:

Estados de autorización de un Echeq emitido:

1. BORRADOR
2. PENDIENTE AUTORIZACION
3. EN PROCESO

¿Qué sucede si no envío uno de los firmantes faltantes o lo envío mal?

La solicitud de emisión, en la API de consulta de Lote, quedará reflejada como “PENDIENTE-AUTORIZACION”. Para ello deberá completar la autorización desde el Ebanking.

Diagrama flujo de Emisión.

En caso de respuestas >= 500, se recomienda consultar en e-banking si el lote fue creado. Para esto debe ir a la sección de Echeqs y hacer una búsqueda por fecha:

Allí se listarán todos los Echeqs, donde podrá encontrar una lista de todos los Echeqs y podrá visualizar haciendo clic en el icono del ojo el estado del Echeq.

Aclaración sobre algunos códigos de errores:

http status code 412: Error debido a alguna condición y/o validación que no se cumple.Puede devolver las siguientes error_code.

• cmc7_not_available: este error ocurre cuando el CMC7 proporcionado ya ha sido procesado anteriormente y no está disponible para su uso.

• cmc7_invalid_type: este error ocurre cuando el tipo de CMC7 proporcionado no corresponde con la fecha de pago ingresada.

• cmc7_invalid_account: este error ocurre cuando el CMC7 proporcionado no pertenece a la cuenta seleccionada para la emisión del ECHEQ.

• invalid_cmc7: este error ocurre cuando el CMC7 proporcionado no existe o no es válido.

• invalid_amount: este error ocurre cuando el monto del ECHEQ supera el límite permitido. Por ejemplo, cuando el monto es mayor a 999,999,999.99.

• cmc7_required: este error ocurre cuando el campo CMC7 es obligatorio ya que se configuro como requerido en ebanking, pero no ha sido proporcionado en la solicitud.

Api para solicitar la emision de un echeq normal o diferido

POST

/v1/echeqs

Se debe tener al menos una cuenta origen habilitada e echeqs disponibles para iniciar la solicitud de emisión de ECHEQs. Con el lot_id obtenido en la respuesta, debe luego consultar el estado de la solicitud. El echeq se considera en estado "emitido-pendiente" cuando el estado de la solicitud es "Aceptado".

Autorizaciones

bearerAuth

Tipo

HTTP (bearer)

Parámetros

Header Parameters

User-Agent*

Header de identificación de cliente que envía la petición.

Tipo

string

Requerido

Ejemplo"nombre-cliente"

trace-id*

Id único de la petición

Tipo

string

Requerido

Ejemplo"416f4961-f677-4c8b-aafa-be6384a035c2"

Formato

"uuid"

Cuerpo de la petición

application/json

{

  

"cmc7": "29900810351940888400080803597",

  

"account": {

  

  

"id": "452638127",

  

  

"type": "CC"

  

},

  

"signatories": [

  

  

{

  

  

  

"document_type": "DNI",

  

  

  

"document_number": "401238493"

  

  

}

  

],

  

"beneficiary": {

  

  

"document_number": "30123456789",

  

  

"document_type": "CUIT",

  

  

"name": "Umbrella S.A"

  

},

  

"notification": {

  

  

"email": "[email protected]",

  

  

"content": "Queda generado el echeq para el pago de la factura número xxxxx"

  

},

  

"payment_date": "2023-10-01",

  

"endorsable": true,

  

"currency": "ARS",

  

"amount": 100.55,

  

"concept_code": "FAC",

  

"note": "Pago de Factura",

  

"subject": {

  

  

"id": "ASD546CXC",

  

  

"reference": "Pago de Compra"

  

}

}

Respuestas

Respuesta exitosa

Content-Type

application/json

{

  

"lot_id": "1652",

  

"cmc7": "29900810351940888400080803597",

  

"created_at": "2023-10-01",

  

"details": {

  

  

"beneficiary": {

  

  

  

"document_number": "30123456789",

  

  

  

"document_type": "CUIT",

  

  

  

"name": "Umbrella S.A"

  

  

},

  

  

"account_id": "452638127",

  

  

"payment_date": "2023-10-01",

  

  

"endorsable": true,

  

  

"amount": 100.55,

  

  

"concept_code": "FAC",

  

  

"note": "Pago de Factura",

  

  

"subject": {

  

  

  

"id": "ASD546CXC",

  

  

  

"reference": "Pago de Compra"

  

  

}

  

}

}

POST

/v1/echeqs

Playground

Servidor

Autorización

bearerAuth

Headers

User-Agent*

trace-id*

Cuerpo

Ejemplos

Powered by VitePress OpenAPI