Notificaciones

La URL de notificaciones debe ser una URL pública del dominio donde quieres recibir notificaciones de las ordenes de compra.

Por ejemplo: "http://myshoes-app.com/callbacks".

Para comenzar a recibir notificaciones, debes enviar la URL a [email protected] indicando tu ID de cliente (Podrás encontrar tu ID de cliente en el Administrador de Qloud.ar).

Envio de notficaciones:

Enviaremos un POST a la callback URL y tu aplicación deberá confirmar mediante un HTTP 200 la recepción correcta. Caso contrario, el mensaje será considerado como "no recibido" y habrá una nueva tentativa de envío.

En el POST enviaremos las siguientes variables:

topic: En este caso el topic será "ordenes" e indicará el tipo de notificacion recibida.
resource: Se trata del ID de orden a consultar.
ordenes: recibirás notificaciones desde la creación y cambios realizados en alguna de tus ventas finalizadas.

Los eventos que disparan notificaciones son los siguientes:

- Nueva orden con pago acreditado por Mobbex.
- Nueva orden con pago acreditado por Mercadopago.
- Nueva orden con pago vía transferencia bancaria.
- Comprobante subido (ordenes con pago vía transferencia bancaria).
- Nueva orden con pago y retiro en sucursal.

Detalles de la Orden

Ejemplo, consutando el ID de orden #28041


https://rest.qloud.ar/orders/28041
            
La respuesta será:

[
[ventaWeb] => 28041
[ciente] => Array
    (
        [id] => 25032
        [DNI] => 23516593
        [CUIT] => 20235165938
        [nombre] => Claudio Zarate
        [email] => [email protected]
        [tel] => 011-38794291

    )

[fecha] => 2022-09-27 09:25:29
[productos] => Array
    (
        [0] => Array
            (
                [sku] => 14817
                [nombre] => Disco Externo 1 Tb Seagate Expansion Negro
                [cantidad] => 1
                [precio] => 67899
                [precio_financiado] => 88717.85
            )

    )

[envio] => Array
    (
    "(RETIRO POR SUCURSAL)"
        [tipo] => Retiro por local
        [costo] => 0
        [free] => 0
        [direccion] => null
        
    "(ENVIO A DOMICILIO)"
        [tipo] => A domicilio
        [costo] => 1700
        [free] => 0/1
        [direccion] => Array
            (
                [calle] => Av Jorge Cura 
                [altura] => 2630
                [piso] => 
                [puerta] => 
                [localidad] => ROSARIO
                [provincia] => Santa fe
                [CP] => 2000
            )
    
    )

[precio] => 67899
[precio_financiado] => 88717.85
[descuento] => 0
[pago] => Array
    (
"(MOBBEX)"
[tipo] => Mobbex
        [pagos] => Array
            (
                [0] => Array
                    (
                        [ID] => NXFR0VBMDHAEZIM1NYJKZI
                        [fecha] => 2023-03-06 11:29:37
                        [valor] => 88717.85
                        [estatus] => approved
                        [estatusDetalle] => accredited
                        [detalle] => Array
                            (
                                [tipo] => card
                                [banco] => Visa
                                [cuotas] => 12
                                [valor_cuota] => 7393.15
                            )

                    )

            )

"(MERCADOPAGO)"
[tipo] => MercadoPago
        [pagos] => Array
            (
                [0] => Array
                    (
                        [ID] => 61566019850
                        [fecha] => 2023-08-01 23:57:22
                        [valor] => 228679
                        [estatus] => approved
                        [estatusDetalle] => accredited
                        [detalle] => Array
                            (
                                [tipo] => credit_card
                                [banco] => visa
                                [cuotas] => 1
                                [valor_cuota] => 228679
                            )

                    )

            )

"(TRANSFERENCIA BANCARIA - S/COMPROBANTE)"
[tipo] => Transferencia
[comprobante] => NULL
* Se genero la orden pero el comprobante no fue enviado.
* Al enviarlo se genera otra notificacón.

"(TRANSFERENCIA BANCARIA - C/COMPROBANTE)"
[tipo] => Transferencia
[comprobante] => Array
    (
        [0] => Array
            (
                [archivo] => https://statics.qloud.ar/compra-elgato-10gat9901.pdf
                [titular] => serratel-sa
                [fecha] => 31/12/1969 09:12:00
            )

"(PAGO EN SUCURSAL)"
[tipo] => Sucursal

        )

    [facturaA] => 0/1
    [mensaje] => 
]

Después de recibir una notificación, deberás realizar una solicitud GET al recurso para acceder a los detalles de la orden.

Autenticación y Autorización

En el header se debe enviar una etiqueta con los datos suministrados:
Authorization: Basic base64_encoded(usuario:contrasena).

Para obtener los detalles de la orden deberas realizar una llamada GET a la siguiente url:

https://rest.qloud.ar/orders/$ID

#ID: Es el ID de orden recibido en la notificación.

DETALLE DE VARIABLES RECIBIDAS

Campo	Tipo	Desacripción
ventaWeb	Integer	ID de venta de qoud

https://www.qloud.ar/api.php?hash=28041&cli=241

Ordenes por fecha

Podras consultar las ordenes de compra por un rango de fechas determinado.