Corporativo API
  1. INGRESO DE DATOS DE VENTA
Corporativo API
  • AUTORIZACION
    • Login
      POST
  • INGRESO ESTADO FINANCIERO
    • Estado Financiero
      POST
    • Estado Financiero V2
      POST
  • INGRESO DE DATOS DE VENTA
    • Datos Venta
      POST
    • Datos Venta V4
      POST
  • INGRESO DE DATOS DE CARTERA
    • Datos Cartera
      POST
  • INGRESO DE DATOS DE COMPRA
    • Datos Compra
      POST
    • Datos Compra Versión 2
      POST
  • INGRESO REGISTROS DE INVENTARIO
    • Datos Inventario
      POST
  • DIVISION POLITICA
    • Ciudades por pais
      GET
  • REPORTE COMERCIAL
    • B2C
      POST
    • B2B
      POST
  • ENVIO DE MENSAJES POR WHATSAPP
    • Mensaje tipo Texto
      POST
    • Mensaje tipo Imagen
      POST
    • Mensaje tipo Ubicación
      POST
    • Mensaje tipo Botón
      POST
    • Mensaje tipo Plantilla
      POST
  1. INGRESO DE DATOS DE VENTA

Datos Venta V4

POST
https://apicorporativo.curbe.com.ec/api/ventas
Recibe un objeto con la información de ventas de un periodo.
AtributoDescripciónTipoRequeridoEjemplo
ref_empresaempresa sobre la que se realiza operacionesstringSI5df22597868a8a73031900cd17bcd
ref_fecha_datosfecha del documento. Cabe indicar el formato de fecha debe ser tipo DateTimestringSI2021-12-20
ref_periodoaño de los datos de carteranumberSI2025
ref_mesInicialmes inicial del conjunto de datosnumberSI1
ref_mesFinalmes final del conjunto de datosnumberSI2
ref_clientesConjunto de objetos de tipo clientearraySI--
Dentro del atributo ref_clientes, se tiene la siguiente estructura:
REF_CLIENTES
AtributoDescripciónTipoRequeridoEjemplo
ref_cli_tipo_idetipo de identificacion del cliente:
- 1 cedula
- 2 ruc
- 3 pasaporte		numberSI1
ref_cli_identificacionnumero de identificacion del clientestringSI0123456789
ref_cli_nombrenombre del clientestringSICliente
ref_cli_celularnumero celular del clientestringNO0123456789
ref_cli_telefononumero de telefono del clientestringNO0123456
ref_cli_mailcorreo electronico del clientestringNOcliente@gmail.com
ref_cli_calle_principalcalle principal del clientestringSIAv. Huaynacapac
ref_cli_calle_secundariacalle secundaria del clientestringNOCalle Larga
ref_cli_ciudad_idcodigo que se reporta al SRI de la tabla de ubicaciones, 0101 Que es Azuay, es los mismo codigos que se manejan en la dinardafstringSI001
ref_cli_ciudadnombre de la ciudad a la que pertenece el clientestringSICuenca
ref_cli_fecha_creacionfecha de creacion del clientestringSI2025-12-30
ref_ventasLista de objetos de tipo ref_ventaarraySI--
A continuación se presentara la estructura del array ref_ventas
REF_VENTAS
AtributoDescripciónTipoRequeridoEjemplo
ref_ven_cedulanumero de identificacion del vendedorstringSI0123456789
ref_ven_nombrenombre del vendedorstringSIvendedor
ref_sup_cedulanumero identificacion de la persona a la que reporta el vendedorstringSIsuperior
ref_sup_nombrenombre de la persona a la que reporta el vendedorstringSIsuperior
ref_zona_idid de la zona en la que se realizo la ventastringSIZon_1
ref_zona_nombrenombre de la zona en la que se realizo la ventastringSIZona 1
ref_almacen_idid del almacen donde se origino la ventastringSIMAT
ref_almacen_nombrenombre del almacen donde se origino la ventastringSIMatriz
ref_alm_ciudad_idcodigo que se reporta al SRI de la tabla de ubicaciones, 0101 Que es Azuay, es los mismo codigos que se manejan en la dinardafstringSI101
ref_alm_ciudad_nombrenombre de la ciudad donde se encuentra el almacen que realizo la ventastringSICuenca
ref_fechafecha en la que se origino la venta. Cabe recalcar que la fecha debe ser enviada en tipo de dato DatetimestringSI2025-12-20
ref_periodoindica el periodo en el que se origino la ventanumberSI2025
ref_mesindica el mes en el que se origino la ventanumberSI12
ref_diaindica el dia en el que se origino la ventanumberSI12
ref_doc_forma_pagoindica la forma de pago
- 01 efectivo
- 02 credito		stringSI01
ref_cuotaindica las cuotas de pago de la ventanumberSI2
ref_ref_doc_plazoplazo para el pago de la ventanumberSI60
ref_pro_skuindica el codigo del productostringSI001SW
ref_pro_nombreindica el nombre del productostringSIproducto
ref_pro_id_nivel1id del primer nivel al que pertenece el productostringSI001
ref_pro_nivel1nombre primer nivel al que pertenece el productostringSInivel 1
ref_pro_id_nivel2id del segundo nivel al que pertenece el productostringSI002
ref_pro_nivel2nombre del segundo nivel al que pertenece el productostringSInivel 2
ref_pro_id_nivel3id del terncer nivel al que pertenece el productostringSI003
ref_pro_nivel3nombre tercer nivel al que pertenece el productostringSInivel 3
ref_pro_marca_idid de la marca del productostringSIAX
ref_pro_marca_nombrenombre de la marca del productostringSIAXE_1
ref_canal_idid del canal de ventastringSICA_1
ref_canal_nombrenombre del canal de ventastringSICANAL_1
ref_doc_tipocodigo del tipo de documento:
- 1 FACTURA
- 2 NOTA CREDITO
- 3 NOTA DE DEBITO		numberSI1
ref_doc_numeronumero de documentostringNOfact
ref_doc_internonumero de documento que se utiliza en el sistema interno y sirve para cartera, contabilidad, inventariosstringNO001
ref_doc_cantidadcantidad del producto vendidonumberSI5
ref_doc_venta_brutavalor el cual indica la venta bruta del productonumberSI50.25
ref_doc_descuentovalor el cual indica descuentos sobre el producto de ventanumberSI0
ref_doc_venta_netavalor el cual indica la venta neta del productonumberSI51.8
ref_doc_costovalor el cual indica el costode ventanumberSI9.5
ref_preciovalor el cual indica el precio del productonumberSI9.5
ref_doc_venta_ivavalor el cual indica el IVA del productonumberSI0.5
ref_icevalor el cual indica el ICE del productonumberSI0
ref_totalvalor que indica el total de la ventanumberSI52.03
ref_pro_id_atributo1codigo del primer nivel de atributo al que pertencestringSI01
ref_pro_atributo1nombre del primer nivel de atributo al que pertenece:
- PROPIO (LO QUE PRODUZCA LA EMPRESA)
- TERCEROS (IMPORTADO))		stringSIPropio
ref_pro_id_atributo2codigo del segundo nivel de atributo al que pertencestringSI01
ref_pro_atributo2nombre del segundo nivel de atributo al que pertence (NACIONAL O IMPORTADO)stringSIImportado
ref_pro_id_atributo3codigo del tercer nivel de atributo al que pertencestringSI002
ref_pro_atributo3nombre del tercer nivel de atributo al que pertence (TIPO PRODUCTO TERMINADO - MERCADERIA)stringSIProducto Terminado
ref_pro_id_atributo4codigo del cuarto nivel de atributo al que pertencestringSI001
ref_pro_atributo4Nombre del cuarto nivel de atributo al que pertence (PROVEEDOR)stringSICeramica Andina
ref_pro_id_atributo5codigo del quinto nivel de atributo al que pertencestringSI001
ref_pro_atributo5nombre del quinto nivel de atributo al que pertence (SEGMENTO: VALUE, MAINSTREAM, PREMIUM, SUPER PREMIUM)stringSIPREMIUM
ref_pro_unidad_idid de la unidad de medida de venta del productostringSIM2
ref_pro_unidad_nombrenombre de la unidad de medida de venta del productostringSIM2
ref_factor_altfactor de conversión para llegar a unidad de medida alternanumberSI1.22
ref_cantidad_altcantidad del producto con unidad de medida alternanumberSI15.38
ref_unidad_alt_idid de la unidad de medida alternastringNOCA
ref_unidad_alt_nombrenombre de la unidad de medida alternastringNOCAJA
ref_pro_inventarioindica si el producto es o no de inventarionumberSI1
ref_pro_operacionalindica si el producto es o no operacionalnumberSI0
ref_ruc_proveedorindicar el número de identificación del proveedorstringSI190001849001
ref_nombre_proveedorindicar el nombre del proveedorstringSIJEmbotelladora Azuaya S.A.
ref_moneda_vtacolocar el id de la moneda con la que fue realizada la transacciónnumberSI2
ref_tipo_cambiocolocar el valor de conversión en caso de que la transacción sea realizada en otra monedanumberSI5658.25
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://apicorporativo.curbe.com.ec/api/ventas' \
--header 'Content-Type: application/json' \
--data-raw '{
  "ref_empresa": "5df22597868a8a73031900cd17bcd",
  "ref_fecha_datos": "2021-12-20",
  "ref_periodo": 2021,
  "ref_mesInicial": 1,
  "ref_mesFinal": 2,
  "ref_clientes": [
    {
      "ref_cli_tipo_ide": 1,
      "ref_cli_identificacion": "0123456789",
      "ref_cli_nombre": "Cliente",
      "ref_cli_celular": "0123456789",
      "ref_cli_telefono": "0123456",
      "ref_cli_mail": "cliente@hotmail.com",
      "ref_cli_calle_principal": "Av. Huaynacap",
      "ref_cli_calle_secundaria": "Calle Largga",
      "ref_cli_ciudad_id": "001",
      "ref_cli_ciudad": "Cuenca",
      "ref_cli_fecha_creacion": "2015-12-30",
      "ref_ventas": [
        {
          "ref_ven_cedula": "0123456789",
          "ref_ven_nombre": "vendedor",
          "ref_sup_cedula": "superior",
          "ref_sup_nombre": "superior",
          "ref_zona_id": "Zon_1",
          "ref_zona_nombre": "Zona 1",
          "ref_almacen_id": "MAT",
          "ref_almacen_nombre": "Matriz",
          "ref_alm_ciudad_id": "101",
          "ref_alm_ciudad_nombre": "Cuenca",
          "ref_fecha": "2021-12-20",
          "ref_periodo": 2015,
          "ref_mes": 12,
          "ref_dia": 12,
          "ref_doc_forma_pago": "01",
          "ref_cuota": 2,
          "ref_ref_doc_plazo": 60,
          "ref_pro_sku": "001SW",
          "ref_pro_nombre": "producto",
          "ref_pro_id_nivel1": "001",
          "ref_pro_nivel1": "nivel 1",
          "ref_pro_id_nivel2": "002",
          "ref_pro_nivel2": "nivel2",
          "ref_pro_id_nivel3": "003",
          "ref_pro_nivel3": "nivel3",
          "ref_pro_marca_id": "AX",
          "ref_pro_marca_nombre: AXE_1": "",
          "ref_canal_id": "CA_1",
          "ref_canal_nombre": "CANAL_1",
          "ref_doc_tipo": 1,
          "ref_doc_numero": "FACT",
          "ref_doc_interno": "001",
          "ref_doc_cantidad": 5,
          "ref_doc_venta_bruta": 50.25,
          "ref_doc_descuento": 0,
          "ref_doc_venta_neta": 51.8,
          "ref_doc_costo": 5.2,
          "ref_precio": 9.5,
          "ref_doc_venta_iva": 0.5,
          "ref_ice": 0,
          "ref_total": 52.03,
          "ref_pro_id_atributo1": "01",
          "ref_pro_atributo1": "Propio",
          "ref_pro_id_atributo2": "01",
          "ref_pro_atributo2": "Importado",
          "ref_pro_id_atributo3": "002",
          "ref_pro_atributo3": "Producto Terminado",
          "ref_pro_id_atributo4": "001",
          "ref_pro_atributo4": "Ceramica Andina",
          "ref_pro_id_atributo5": "001",
          "ref_pro_atributo5": "PREMIUM",
          "ref_pro_unidad_id": "M2",
          "ref_pro_unidad_nombre": "M2",
          "ref_factor_alt": 1.22,
          "ref_cantidad_alt": 15.38,
          "ref_unidad_alt_id": "CA",
          "ref_unidad_alt_nombre": "CAJA",
          "ref_pro_inventario": 1,
          "ref_pro_operacional": 0,
          "ref_ruc_proveedor": "190001849001",
          "ref_nombre_proveedor": "JEmbotelladora Azuaya S.A.",
          "ref_moneda_vta": 2,
          "ref_tipo_cambio": 5658.25
        }
      ]
    }
  ]
}'
Response Response Example
200 - Datos Venta V4 (200 OK) - Datos Venta V4 (200 OK)
{
    "empresa":"asnoajwedissamlaowmdolsa",
    "fecha_datos":"2021-12-01",
    "total_registros":550,
    "suma_total": 123456.30,
    "errores":[]
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
ref_empresa
string 
required
ref_fecha_datos
string 
required
ref_periodo
integer 
required
ref_mesInicial
integer 
required
ref_mesFinal
integer 
required
ref_clientes
array [object {12}] 
required
ref_cli_tipo_ide
integer 
optional
ref_cli_identificacion
string 
optional
ref_cli_nombre
string 
optional
ref_cli_celular
string 
optional
ref_cli_telefono
string 
optional
ref_cli_mail
string 
optional
ref_cli_calle_principal
string 
optional
ref_cli_calle_secundaria
string 
optional
ref_cli_ciudad_id
string 
optional
ref_cli_ciudad
string 
optional
ref_cli_fecha_creacion
string 
optional
ref_ventas
array [object {63}] 
optional
Examples

Responses

🟢200Datos Venta V4 (200 OK)
application/json
Body
empresa
string 
required
fecha_datos
string 
required
total_registros
integer 
required
suma_total
number 
required
errores
array
required
🟢200Datos Venta V4 (500 ISE)
Modified at 2025-05-29 17:52:13
Previous
Datos Venta
Next
INGRESO DE DATOS DE CARTERA
Built with