Preguntas más frecuentes

Cómo dar de alta una venta a través de la API

image


Peticiones GET

Detalle

Petición
curl -X GET "https://cianbox.org/{cuenta}/api/{usuario}/{contraseña}/{venta|cobro|pago}/detalle/{id}"

Respuesta
{
    "id": "15",
    "cliente": {
        "title": "Cliente",
        "value": "Juan Pedro Monzón"
    },
    "comprobante": {
        "title": {
            "comp": "Comprobante",
            "fecha": "Fecha"
        },
        "value": {
            "comp": "FAC [A] 0003-00000003",
            "fecha": "2016-02-17"
        }
    },
    "fecha_carga": {
        "title": "Fecha de Carga",
        "value": "2016-02-19 18:01:05"
    },
    "observaciones": {
        "title": "Observaciones",
        "value": "Incluir llavero de regalo"
    },
    "detalles": {
        "title": "Detalles",
        "value": [
            {
                "id": 31,
                "codigo": "1185",
                "producto": "Zapatilla Nike Nº5",
                "cantidad": 1,
                "alicuota": 21,
                "neto_uni": 974.25
            },
            {
                "id": 32,
                "codigo": "256",
                "producto": "Pelota de Basket Spadding",
                "cantidad": 2,
                "alicuota": 21,
                "neto_uni": 419
            }
        ]
    },
    "subtotales": {
        "title": "Subtotales",
        "value": {
            "exento": 0,
            "gravado": 419,
            "no_gravado": 0,
            "iva": "21,00%"
        }
    },
    "total": {
        "title": "Total",
        "value": 2192.82
    },
    "condicion": {
        "title": "Condición",
        "value": "Cuenta Corriente :: Saldo: $ 2.192,82"
    },
    "estado": {
        "title": "Estado",
        "value": "Entregado el 17\/02\/2016"
    },
    "sucursal": {
        "title": "Sucursal",
        "value": "Casa Central"
    },
    "url": "https://cianbox.org/usr/micuenta/reports/000001/2016/02/fac-a-0003-00000003.pdf"
}

Talonarios

Petición
curl -X GET "https://cianbox.org/{cuenta}/api/{usuario}/{contraseña}/{venta|cobro|pago}/talonarios"

Respuesta
[
    {
        "id": 1,
        "nombre": "FACTURA A",
        "comprobante": "Factura",
        "abreviado": "FAC",
        "tipo": "A",
        "punto_venta": "0010"
    },
    {
        "id": 2,
        "nombre": "Nota de Débito A",
        "comprobante": "Nota de Débito",
        "abreviado": "NOD",
        "tipo": "A",
        "punto_venta": "0010"
    },
    {
        "id": 3,
        "nombre": "Nota de Crédito A",
        "comprobante": "Nota de Crédito",
        "abreviado": "NOC",
        "tipo": "A",
        "punto_venta": "0010"
    },
    {
        "id": 5,
        "nombre": "FACTURA B",
        "comprobante": "Factura",
        "abreviado": "FAC",
        "tipo": "B",
        "punto_venta": "0010"
    },
    {
        "id": 6,
        "nombre": "Nota de Crédito B",
        "comprobante": "Nota de Crédito",
        "abreviado": "NOC",
        "tipo": "B",
        "punto_venta": "0010"
    },
    {
        "id": 7,
        "nombre": "Nota de Débito B",
        "comprobante": "Nota de Débito",
        "abreviado": "NOD",
        "tipo": "B",
        "punto_venta": "0010"
    }
]

Altas PUT

Nueva Venta

Petición
curl -X PUT -d '{JSON}' "https://cianbox.org/{cuenta}/api/{usuario}/{contraseña}/venta/alta"

Ejemplo de {JSON}
{
    "fecha": "2016-02-17",
    "id_talonario": 2,
"numero": 154,
    "cliente": {
        "codigo": 574,
        "razon": "Juan Pedro Monzón",
        "condicion": "RI",
        "tipo_documento": "CUIT",
        "numero_ducumento": 99664441118,
        "domicilio": "Calle SN 1478",
        "localidad": "Rosario",
        "provincia": "Santa Fé"
    },
    "forma_pago": "CTACTE",
    "vencimiento": "2016-02-25",
    "observaciones": "Incluir llavero de regalo",
    "detalles": [
        {
            "codigo": 1185,
            "producto": "Zapatilla Nike Nº5",
            "cantidad": 1.0000,
            "alicuota": 21.0000,
            "neto_uni": 974.2500
        },
        {
            "codigo": 256,
            "producto": "Pelota de Basket Spadding",
            "cantidad": 2.0000,
            "alicuota": 21.0000,
            "neto_uni": 419.0000
        }
    ]
}

Campo Tipo Detalle
fecha String Fecha del comprobante en formato YYYY-MM-DD
id_talonario Integer Identificador del talonario obtenido dehttps://cianbox.org/{cuenta}/api/{usuario}/{contraseña}/venta/talonarios
numero Integer Número del comprobante. Si es 0 (cero) o no se pasa el campo se asigna automáticamente
cliente Object Contiene los datos del cliente
cliente/codigo Integer/String Código único que identifica al cliente
cliente/razon String Razón social del cliente
cliente/condicion String Condición fiscal del cliente (RI: Responsable Inscripto, MT: Monotributista, EX: IVA Exento oCF: Consumidor Final)
cliente/tipo_documento String Tipo de documento del cliente (CUIT, CUIL o DNI)
cliente/numero_documento Integer Número de documento del cliente, no debe contener puntos ni guiones
cliente/domicilio String Domicilio del cliente
cliente/localidad String Localidad del cliente
cliente/provincia String Provincia del cliente
forma_pago String Forma de pago (CTACTE o CONTADO)
vencimiento String Fecha del vencimiento del comprobante en formato YYYY-MM-DD
observaciones String Observaciones del comprobante
detalles Array Contiene los detalles del comprobante
detalles/codigo Integer/String Código único que identifica al producto
detalles/producto String Descripción del producto
detalles/cantidad Integer/Float Cantidad de productos vendidos
detalles/alicuota Float Alícuota de I.V.A. Ej: 21.0000, 10.5000
detalles/neto_uni Float Precio Neto de I.V.A. y Unitario del producto


Respuesta
{
    "status": "ok",
    "description": "La venta se cargó correctamente",
    "id": 20,
    "url": "https://cianbox.org/micuenta/usr/micuenta/reports/000001/2016/02/fac-a-0003-00000007.pdf"
}



Últimas actualizaciones hace 6 años

Por favor espere!

Por favor espere un instante