Crear comprobante

POST

/walletentidad-comprobante/v1/api/v1.201/Comprobante

Crea un nuevo comprobante de ajuste de saldo en una cuenta.

La entidad debe crear sus propios tipos de comprobante. No tiene permitido utilizar los tipos de comprobante reservados para operaciones internas del sistema (como los IdTipoComprobante 1, 2, 3, 4, 5 y 6) ya que puede resultar en dificultades para el proceso de conciliación.

Request

idTipoComprobante string
— REQUIRED
Identificador del tipo de comprobante. La entidad puede crear y gestionar sus propios tipos de comprobante.
No está permitido utilizar los tipos de comprobante reservados para operaciones internas del sistema (IdTipoComprobante: 1, 2, 3, 4, 5 y 6).

idCuenta string
— REQUIRED
Identificador de la cuenta sobre la cual quiere realizarse el ajuste de saldo.

importe double
— REQUIRED
Valor del importe del ajuste de saldo.

referencia string
— OPTIONAL
Referencia externa del comprobante a aplicar. Se graba para consultas y conciliaciones.
Longitud máxima: 50 caracteres.

idComprobanteRelacionado string
— OPTIONAL
Identificador de otro comprobante relacionado a este, si lo hubiera o si se quisiera relacionar.

idExterno string
— OPTIONAL
Identificador o código externo de la entidad que quiera relacionar a este comprobante. Se graba para consultas y conciliaciones.
Longitud máxima: 50 caracteres.

fechaExterna string
— OPTIONAL
Fecha (sólo informativa) externa de la entidad que quiera relacionar a este comprobante. Se graba para consultas y conciliaciones.

curl request

Copy code

curl --location 'https://gw-staging-qrbind.epays.services/walletentidad-comprobante/v1/api/v1.201/Comprobante' \
--header 'Authorization: Bearer {{access_token}}'
--header 'Content-Type: application/json' \
--data '{
    "idTipoComprobante": 357,
    "idCuenta": 274931,
    "importe": 100,
    "referencia": "Recarga",
    "idComprobanteRelacionado": null,
    "idExterno": "123",
    "fechaExterna": "2024-09-03"
}'

Response

id int
Identificador del comprobante creado.

saldo double
Saldo actual de la cuenta luego de haber creado exitosamente este comprobante.

HTTP 201

Creación exitosa

HTTP 422

Tipo de comprobante inválido

HTTP 422

Cuenta inválida

HTTP 422

idExterno inválido

HTTP 401

Token de autenticación inválido

Guías

¿Qué debes tener en cuenta del saldo?

API Reference

POST

Crear comprobante

GET

Consultar tipos de comprobante

POST

Crear tipo de comprobante

DEL

Eliminar tipo de comprobante

GET

Consultar comprobante por ID

GET

Consultar comprobante por ID ext.

GET

Consultar saldo actual por ID

GET

Consultar saldo actual por CVU

GET

Consultar saldos actuales

GET

Consultar saldo histórico por ID

GET

Consultar saldo histórico por CVU

GET

Consultar saldos históricos