Api iConta
iConta
  1. Compras
  • Introducción
  • Persona
    • Estándar Persona
    • Consultar Persona
      POST
    • Guardar Persona
      POST
    • Listar Personas
      POST
    • Modificar Persona
      POST
  • Cotización
    • Estandar Unidad Tiempo
    • Fuentes de Venta
      • Consultar Fuentes de Venta
    • Detalle Cotización
      POST
    • Lista Cotización
      POST
    • Generar Cotización
      POST
    • Anular Cotización
      POST
    • Lista Campo Adicional Cotización
      POST
  • Facturas
    • Forma Pago
      • Listar Forma Pago
    • Tipo Comprobante
      • Lista Tipo Comprobante
    • Anular Factura
      POST
    • Consultar Forma Pago
      POST
    • Generar Factura
      POST
    • Enviar Factura SRI
      POST
    • Listar Estado Factura
      POST
  • Guía de Remisión
    • Genera Guía de Remisión
      POST
    • Anular Guía de Remisión
      POST
    • Consultar Guía de Remisión
      POST
  • Compras
    • Generar Compra
      POST
    • Listar Compras
      POST
    • Detalle Compra
      POST
  • Bancos
    • Listar Chequera
    • Listar Lotes/Tarjetas
  • Inventario
    • Estandar Tipo Movimiento Inventario
    • Bodega
      • Listar Bodega
    • Producto
      • Tipo Producto
        • Listar Tipo Producto
        • Guarda Tipo Producto
      • Unidad
        • Lista Unidad
      • Categoria
        • Listar Categoria
        • Guarda Categoria
        • Guardar Categoría con Cuentas Contables por Defecto
      • Marca
        • Listar Marca
        • Guarda Marca
      • Impuestos
        • Lista Impuestos Agregado
        • Lista Impuesto Consumo Especial
      • Detalle Producto
      • Listar Producto
      • Generar Producto
      • Listar Producto Precio
      • Punto Emisión Producto
    • Listar Movimiento Inventario
    • Generar Movimiento Inventario
  • Centro de Costos
    • Generar Centro de Costo
    • Listar Centros de Costo
    • Modificar Centro de Costo
  • Cobros / Pagos
    • Estandar Cobros/Pagos
    • Anular Cobro/Pago
    • Detalle Documento
    • Generar Cobro
    • Generar Pago
    • Listar Documentos
  • Contable
    • Consultar Contable
  • Nota de Crédito
    • Consulta Factura para Aplicar Nota de Crédito
    • Generar Nota de Crédito
    • Anular Nota de Crédito
    • Envio Nota de Crédito al SRI
    • Consultar Estado Nota de Crédito
  1. Compras

Generar Compra

POST
api/external/compra/genera
Este servicio permite generar y registrar una nueva factura de compra dentro del sistema.
Este documento es esencial para el control de las transacciones comerciales, ya que detalla la adquisición de productos o servicios, adaptándose tanto a las necesidades operativas del usuario como a la normativa legal vigente.

Códigos ICE configurados en iConta#

A continuación, se detallan los códigos ICE que están actualmente registrados en la base de datos. Estos códigos representan el catálogo general almacenado por el sistema.
Importante: La empresa debe configurar en el sistema únicamente los códigos ICE que realmente utiliza en sus operaciones. Es responsabilidad del usuario o del administrador seleccionar y activar los códigos correspondientes según las necesidades de la organización.
CódigoNombre
00NINGUNO
3093TELEFONIA 15%
3681PLAN CELULAR 10%
3092TELEVISION PAGADA 15%
3620VIDEOJUEGOS 35%
3610PERFUMES 20%
3680FUNDAS PLÁSTICAS
3043CERVEZA ARTESANAL
3111BEBIDAS NO ALCOHOLICAS
3680FUNDAS Y PORTAVASOS

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros del Body application/jsonRequerido

Ejemplo
   {
     "id_sistema": "123456",
     "tipo_documento": "01",
     "fecha_emision": "19/06/2025",
     "fecha_vencimiento": "19/06/2025",
     "establecimiento": "001",
     "punto_emision": "002",
     "secuencia": "000006023",
     "autorizacion": "123456789",
     "codigoCreditoTributario": "02",
     "cliente_intermediario": {
       "ruc": "120759373001",
       "cedula": "1700000000",
       "pasaporte": "PAST001254",
       "razon_social": "EMPRESA DE PRUEBA",
       "telefono": "0980000000",
       "direccion": "Direccion del cliente",
       "email": "test@iconta.ec"
     },
     "proveedor": {
       "ruc": "1700000000001",
       "cedula": "1700000000",
       "pasaporte": "PAST001254",
       "razon_social": "EMPRESA DE PRUEBA",
       "telefono": "0980000000",
       "direccion": "Direccion del proveedor",
       "email": "test@iconta.ec",
       "esSujetoRetencion": true,
       "codigo_cuenta_contable_proveedor": "21312"
     },
     "concepto": "Detalle de la compra a generar",
     "tiene_retencion_manual": true,
     "establecimiento_retencion": "001",
     "punto_emision_retencion": "002",
     "retencion": {
       "eselectronica": false,
       "establecimiento": "001",
       "puntoemision": "002",
       "secuencia": "4445",
       "autorizacion": "1234567890",
       "claveacceso": "12354",
       "fechaemision": "17/06/2025"
     },
     "detalles": [
       {
        "producto": {
           "verifica_crea_producto": true,
           "codigo_producto": "PC102",
           "nombre_producto": "SERV. COURIER SHEIN",
           "id_categoria_producto": 0,
           "id_tipo_producto": 0,
           "id_marca_producto": 0,
           "codigo_unidad_producto": "U",
           "id_bodega": 1,
           "id_centro_costo": 0
         },
         "esbien": false,
         "valordescuento": "0.00",
         "cantidad": "1",
         "valor_unitario": "15.00",
         "iva_aplicado": "15.00",
         "ice_aplicado": "0.00",
         "codigo_ret_iva": "1",
         "codigo_ret_renta": "310"
       },
         {
           "codigo_cuenta_contable": "11112",
         "detalle": "prueba producto",
         "esbien":false,
         "valordescuento": "0.00",
         "cantidad": "10",
         "valor_unitario": "15",
         "iva_aplicado": "15",
         "ice_aplicado": "00",
         "codigo_ret_iva": "1",
         "codigo_ret_renta": "310"
         },
          {
           "producto": {
           "codigo_producto": "PC102",
           "id_bodega": 1
         },
         "esbien":true,
         "valordescuento": "0.00",
         "cantidad": "10",
         "valor_unitario": "15",
         "iva_aplicado": "15",
         "ice_aplicado": "00",
         "codigo_ret_iva": "1",
         "codigo_ret_renta": "310"
   
         }
     ],
     "pagos": [
       {
         "codigo_forma_pago": "01-111314",
         "documento": "0000000",
         "id_centro_costo": 0,
         "valor": "16.42"
       }
     ]
   }
  

Respuestas

🟢200Éxito
application/json
Body

Ejemplo
{
    "id_compra": 1185735,
    "numero_comprobante": "001-002-000006020",
    "numero_retencion": "001-002-000004445",
    "sF_ExisteError": false,
    "sF_Error": null
}
Anterior
Consultar Guía de Remisión
Siguiente
Listar Compras
Built with