1. Inicio
  2. API
  3. Cómo dar de alta una venta a través de la API

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

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
        }
    ]
}
CAMPOTIPODETALLE
fechaStringFecha del comprobante en formato YYYY-MM-DD
id_talonarioIntegerIdentificador del talonario obtenido de https://cianbox.org/{cuenta}/api/{usuario}/{contraseña}/venta/talonarios
numeroIntegerNúmero de comprobante. Si es 0 (cero) o no se pasa el campo se asigna automáticamente.
clienteObjectContiene los datos del cliente.
cliente/codigoInteger/StringCódigo único que identifica al cliente.
cliente/razonStringRazón social del cliente.
cliente/condicciónStringCondición fiscal del cliente (RI: Responsable Inscripto, MT: Monotributista, EX: IVA Exento o CF: Consumidor Final)
cliente/tipo_documentoStringTipo de documento del cliente (CUIT, CUIL o DNI)
cliente/numero_documentoIntegerNúmero de documento del cliente, no debe contener puntos ni guiones.
cliente/domicilioStringDomicilio del cliente.
cliente/localidadStringLocalidad del cliente.
cliente/provinciaStringProvincia del cliente.
forma_pagoStringForma de pago (CTACTE o CONTADO)
vencimientoStringFecha del vencimiento del comprobante en formato YYYY-MM-DD.
observacionesStringObservaciones del comprobante.
detallesArrayContiene los detalles del comprobante.
detalles/codigoInteger/StringCódigo único que identifica al producto.
detalles/productoStringDescripción del producto.
detalles/alicuotaFloatAlícuota de IV.A. Ej: 21.0000, 10.5000.
detalles/neto_uniFloatPrecio 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"
}

Actualizado 30 de enero de 2024

¿Esta guía te fue útil?

Artículos relacionados

¿Necesitas ayuda?
¿No encontrás lo que estás buscando? Estamos para ayudarte.
Contactar Soporte