Autentificación

Usuario y clave proporcionados por iSas Cloud previo registro de la empresa, necesarios para la autentificación e ingreso a la Api Cucu.

POST https://sandbox.cucu.bo/electronica/api/v2/auth/login

Body

{
  "username": "admin",
  "password": "123456"
}

Respuesta

{
  "status_message": "Se verifico las credenciales del Usuario exitosamente",
  "success": true,
  "status_code": 200,
  "data": {
    "username": "admin",
    "token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJhZG1pbiIsImlkVXN1YXJpbyI6MSwicm9sIjoiU1VQRVJfQURNSU4iLCJpYXQiOjE2MjM4NzI4MTEsImV4cCI6MTYyMzg3NjQxMX0.W5130asFPu6k4F71STHA36AmliZIF54OKYojfB46j9A"
  }
}

El token generado proporciona acceso a todos los recursos de la Api Cucu, el mismo tiene una duración de 4 hora posterior a esto deberá ser regenerado.

Sucursal

Sucursal o sucursales con las que cuenta la empresa registrables por la propia empresa, registro debe realizarse tanto en impuestos como en la Api Rest Cucu.

Registrar Sucursal

Crea una nueva sucursal para una empresa, solicitud bajo el idEmpresa a la cual será asignada la nueva sucursal.

POST https://sandbox.cucu.bo/electronica/api/v2/sucursal/crear

Body

{
  "nombre": "CASA MATRIZ CUCU ELECTRONICA CAMACHO",
  "municipio": "LA PAZ",
  "direccion": "Av, Camacho Esq. Loayza Edificio Saenz #1389 Piso 1",
  "ciudad": "LA PAZ",
  "telefono": "78817944",
  "descripcion": "casa matriz Facturacion ELECTRONICA EN LINEA V2",
  "nit": 6816755019,
  "fidEmpresa": 5
}

Respuesta

{
  "status_message": "SUCURSAL CREADA",
  "success": true,
  "status_code": 200,
  "data": {
    "idSucursal": 15,
    "nombre": "CASA MATRIZ CUCU ELECTRONICA",
    "municipio": "LA PAZ",
    "direccion": "AV, CAMACHO ESQ. LOAYZA EDIFICIO SAENZ #1389 PISO 1",
    "ciudad": "LA PAZ",
    "telefono": "78817944",
    "descripcion": "CASA MATRIZ FACTURACION ELECTRONICA EN LINEA V2",
    "codigo": 0,
    "nit": 6816755019,
    "estado": "ACTIVO",
    "fidEmpresa": 5
  }
}

Punto de Venta

Punto de venta o puntos de venta con las que cuenta la sucursal registrables por la propia empresa.

Registrar Punto de Venta

Crea un nuevo punto de venta para una sucursal, solicitud bajo el idSucursal a la cual será asignado el nuevo Punto de Venta.

POST https://sandbox.cucu.bo/electronica/api/v2/puntoVenta/crear

Body

{
  "nombre": "punto de venta 2 cucu electronica",
  "descripcion": "Punto de Venta facturacion Cucu Electronica",
  "tipo": 5,
  "fidSucursal": 15
}

Respuesta

{
  "status_message": "PUNTO DE VENTA REGISTRADO",
  "success": true,
  "status_code": 200,
  "data": {
    "idPuntoVenta": 38,
    "nombre": "PUNTO DE VENTA 2 CUCU ELECTRONICA",
    "descripcion": "PUNTO DE VENTA FACTURACION CUCU ELECTRONICA",
    "codigo": 68,
    "tipo": 5,
    "tipoEmision": 1,
    "cuis": "B47B5B3",
    "vigenciaCuis": "2022-06-16T23:25:08.824+00:00",
    "estado": "ACTIVO",
    "fidSucursal": 15
  }
}

Factura

Factura de compra y venta, asociada a una venta una ves efectuada o creada.

Registrar Factura

Crea una nueva factura asociada a una venta o compra realizada, solicitud efectuada bajo el idPuntoVenta. Requisitos necesarios los certificados para poder emitir y firmar la factura.

https://sandbox.cucu.bo/electronica/api/v2/factura/crear

Body

{
  "idPuntoVenta": 38,
  "codigoCliente": 4,
  "codigoTipoDocumentoIdentidad": 1,
  "numeroDocumento": "12345678",
  "complemento": "LP",
  "nombreRazonSocial": "CUCU ELECTRONICA",
  "codigoMetodoPago": 1,
  "montoTotal": 0,
  "montoTotalSujetoIva": 0,
  "tipoCambio": 1,
  "montoTotalMoneda": 0,
  "tipoEmision": 0,
  "detalle": [
    {
      "idItem": 2,
      "cantidad": 10
    },
    {
      "idItem": 3,
      "cantidad": 13
    }
  ]
}

Respuesta

{
  "status_message": "FACTURA REGISTRADA",
  "success": true,
  "status_code": 200,
  "data": {
    "idVenta": 40421,
    "numeroFactura": 38691,
    "numeroDocumento": "64964862",
    "nombreRazonSocial": "CUCU FACTURACION ELECTRONICA",
    "monto": 1910.0,
    "cuf": "1D26BDAB032E33016E115BA4554EFD0647DA63A4A815556F7E6C27DC74",
    "codigoRecepcion": "8210d831-b06a-49c0-90d8-31b06a09c07b",
    "estado": "VALIDO",
    "fidPuntoVenta": 38,
    "fidCliente": 4,
    "qr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6816755019&cuf=1D26BDAB032E33016E115BA4554EFD0647DA63A4A815556F7E6C27DC74&numero=38691&t=1"
  }
}

Venta

Creada la factura automáticamente se creara una nueva venta asociada a esa factura. Contendrá datos relevantes de quien emite la factura, el cliente a quien se ha emitido la factura, la factura en formato XML, el código QR verificador con el SIN.

Anular Venta

Permite anular una venta registrada en impuestos como requisito para este recurso se debe proporcionar el motivo por el cual se esta anulando la venta además del idVenta que se quiere anular.

PUT `https://sandbox.cucu.bo/electronica/api/v2/venta/anular/40421

Body

{
  "motivo": 1
}

Respuesta

{
  "status_message": "VENTA ANULADA",
  "success": true,
  "status_code": 200,
  "data": {
    "idVenta": 40421,
    "numeroFactura": 38691,
    "numeroDocumento": "64964862",
    "nombreRazonSocial": "CUCU FACTURACION ELECTRONICA",
    "monto": 1910.0,
    "cuf": "1D26BDAB032E33016E115BA4554EFD0647DA63A4A815556F7E6C27DC74",
    "codigoRecepcion": "8210d831-b06a-49c0-90d8-31b06a09c07b",
    "estado": "ANULADO",
    "fidPuntoVenta": 38,
    "fidCliente": 4,
    "qr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6816755019&cuf=1D26BDAB032E33016E115BA4554EFD0647DA63A4A815556F7E6C27DC74&numero=38691&t=1"
  }
}

Revertir Anulación

Permite revertir la anulación de una venta registrada en impuestos, para este recurso se debe proporcionar el idVenta que se quiere revertir.

PUT `https://sandbox.cucu.bo/electronica/api/v2/venta/revertir/40421
{
  "status_message": "VENTA REVERTIDA",
  "success": true,
  "status_code": 200,
  "data": {
    "idVenta": 40421,
    "numeroFactura": 38691,
    "numeroDocumento": "64964862",
    "nombreRazonSocial": "CUCU FACTURACION ELECTRONICA",
    "monto": 1910.0,
    "cuf": "1D26BDAB032E33016E115BA4554EFD0647DA63A4A815556F7E6C27DC74",
    "codigoRecepcion": "8210d831-b06a-49c0-90d8-31b06a09c07b",
    "estado": "VALIDO",
    "fidPuntoVenta": 38,
    "fidCliente": 4,
    "qr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6816755019&cuf=1D26BDAB032E33016E115BA4554EFD0647DA63A4A815556F7E6C27DC74&numero=38691&t=1"
  }
}

Obtener Detalle de Impresión

Obtiene el detalle de los campos relevantes de la venta, para impresión de factura.

GET https://sandbox.cucu.bo/electronica/api/v2/venta/detalle/40421
{
  "status_message": "DETALLE DE IMPRESION",
  "success": true,
  "status_code": 200,
  "data": {
 	"nombreRazonSocialEmisor": "CUCU ELECTONICA",
  	"nombrePuntoVenta": "CASA MATRIZ CUCU ELECTRONICA CAMACHO",
  	"nroPuntoVenta": 67,
  	"direccion": "Av, Camacho Esq. Loayza Edificio Saenz #1389 Piso 1",
  	"telefono": "70411258",
  	"municipio": "LA PAZ",
  	"nit": 6816755019,
  	"nroFactura": 38691,
  	"cuf": "1D26BDAB032E33016E115BA4554EFD0647DA63A4A815556F7E6C27DC74",
  	"actividad": "ACTIVIDADES DE DISEÑO E IMPLEMENTACIÓN DE SISTEMAS INFORMÁTICOS",
  	"fecha": "2021-06-17T21:30:43.000+00:00",
  	"nombreRazonSocial": "CUCU FACTURACION ELECTRONICA",
  	"nroDocumento": "64964862",
  	"detalle": [
    	{
      		"codProductoServicio": "002",
      		"cantidad": 10.0,
      		"descripcion": "SERVICIOS FREELANCER",
      		"precioUnitario": 100.0,
      		"descuento": 0.0,
      		"subTotal": 1000.0
        },
        {
          	"codProductoServicio": "003",
          	"cantidad": 13.0,
          	"descripcion": "CAPACITACION",
          	"precioUnitario": 70.0,
          	"descuento": 0.0,
          	"subTotal": 910.0
        }
  ],
  	"montoTotal": 1910.0,
  	"descuentoTotal": 0.0,
  	"importeCredFiscal": 1910.0,
  	"qr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=6816755019&cuf=1D26BDAB032E33016E115BA4554EFD0647DA63A4A815556F7E6C27DC74&numero=38691&t=1",
	"literal":"MIL NOVECIENTOS DIEZ"
  	"leyenda": "Ley N° 453: Tienes derecho a un trato equitativo sin discriminación en la oferta de servicios."
  }
}

Obtener PDF Factura Compra y Venta

Permite visualizar la factura correspondiente a una venta o compra en formato PDF, para este recurso se debe proporcionar el idVenta.

Requerimientos

ParámetroTipoDescripción
formatoint1 formato normal A4, 2 Formato Ticket.
GET https://sandbox.cucu.bo/electronica/api/v2/venta/vista/40421

Formato A4

Formato Ticket

Obtener PDF Factura Compra y Venta (Descargable)

Permite descargar la factura correspondiente a una venta o compra en formato PDF, para este recurso se debe proporcionar el idVenta.

Requerimientos

ParámetroTipoDescripción
formatoint1 formato normal A4, 2 Formato Ticket.
GET https://sandbox.cucu.bo/electronica/api/v2/venta/descargar/40421

PDF Generate

Enviar Correo Electrónico

Permite enviar mediante correo electrónico la factura en formato PDF y en formato XML con la firma digital respectiva, para este recurso se debe proporcionar el idventa.

POST https://sandbox.cucu.bo/electronica/api/v2/venta/enviarCorreo/81

Body

{
  "destino": "api@cucu.bo",
  "asunto": "Envio de Factura Electronica",
  "cliente": "Rene Espinoza Chavez"
}

Respuesta

{
  "status_message": "ENVIO DE CORREO",
  "success": true,
  "status_code": 200,
  "data": {
      "Correo electronico enviado satisfactoriamente..."
  }
}