Qloud API - Documentación

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
            [DIRECCION] => Array
                (
                    [CALLE] => Adolfo Alsina 
                    [ALTURA] => 1433
                    [PISO] => 2
                    [PUERTA] => A
                    [LOCALIDAD] => Montzerrat
                    [PROV] => Capital federal
                    [CP] => 1088
                )

        )

    [fecha] => 2022-09-27 09:25:29
    [productos] => Array
        (
            [0] => Array
                (
                    [SKU] => 14817
                    [VAR] => 
                    [NOMBRE] => Disco Externo 1 Tb Seagate Expansion Negro
                    [CANTIDAD] => 1
                    [VALOR] => 9954.00
                )

        )

    [envio] => Array
        (
            [tipo] => Retiro por Local
            [costo] => 0
            [free] => 0
        )

    [precio] => 9954
    [descuento] => 0
    [pago] => Array
        (
            [tipo] => Transferencia
            [comprobante] => Array
                (
                    [archivo] => 
                    [titular] => 
                    [fecha] => 
                )

        )

    [facturaA] => 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

Ordenes por fecha

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