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

POST
https://apicorporativo.curbe.com.ec/api/compras/save/api
Recibe un objeto con la información de la compra de un periodo.
Atributos:
AtributoDescripcionTipoRequeridoEjemplo
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 carteranumberSI2021
ref_mesInicialMes inicial del conjunto de datosnumberSI1
ref_mesFinalMes final del conjunto de datosnumberSI1
ref_clientesArray de clientes---SI---
A continuación se presenta el atributo ref_clientes para poder enviar array:
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_celularNúmero de celular de clientestringNO0123456789
ref_cli_telefonoNúmero de teléfono del clientestringNO0123456
ref_cli_mailCorreo electrónico del clientestringNOcliente@gmail.com
ref_cli_calle_principalCalle principal del clientestringSIAv. Huaynacapa
ref_cli_calle_secundariaCalle secundaria del clientestringCalle Larga
ref_cli_ciudad_idCodigo que se reporta al SRI de la tabla de ubicaciones, 0101 que es Azuay, son los mismo codigos que se manejan en la dinadafstringSI001
ref_cli_ciudadNombre de la ciudad a la que pertenece el clientestringSICuenca
ref_cli_fecha_creacionFecha de creación de clientestringSI2025-12-30
ref_ventasarray--SI--
A continuación se presenta el atributo ref_ventas para poder enviar array:
REF_VENTAS
AtributoDescripciónTipoRequeridoEjemplo
ref_ven_cedulaNúmero de identificacion del vendedorstringSI0123456789
ref_ven_nombreNombre del vendedorstringSIvendedor
ref_sup_cedulaNúmero de identificación de la persona a la que reporta el vendedorstringSI0123456789
ref_sup_nombreNombre de la persona a la que reporta el vendedorstringSIsuperior
ref_zona_idId de la zona que 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 almacén donde origino la ventastringSImat
ref_almacen_nombreNombre del almacén 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 Datetime.stringSI2025-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 (1 efectivo, 2 credito)stringSI01
ref_cuotaindica las cuotas de pago de la ventanumberSI2
ref_ref_doc_plazoplazo para el pago de la ventanumberSI60
ref_pro_sku12-D (string, required) - indica el codigo del productostringNO11
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 productostringSIAX_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 documentostringNO000072737
ref_doc_internonumero de documento que se utiliza en el sistema interno y sirve para cartera, contabilidad, inventariosstringNO001-000072797
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 ventanumberSI5.2
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 pertence (PROPIO (LO QUE PRODUZCA LA EMPRESA) O 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)stringSICeraminca Andina
ref_pro_id_atributo5codigo del quinto nivel de atributo al que pertenecestringSI001
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_altnombre de la unidad de medida de venta del productonumberSI1.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
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://apicorporativo.curbe.com.ec/api/compras/save/api' \
--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": "11",
          "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
        }
      ]
    }
  ]
}'
Response Response Example
200 - Datos Venta (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
empresa sobre la que se realiza operaciones
ref_fecha_datos
string 
required
fecha del documento. Cabe indicar el formato de fecha debe ser tipo DateTime
ref_periodo
integer 
required
año de los datos de cartera
ref_mesInicial
integer 
required
mes inicial del conjunto de datos
ref_mesFinal
integer 
required
mes final del conjunto de datos
ref_clientes
array [object {12}] 
required
ref_cli_tipo_ide
integer 
required
tipo de identificacion del cliente (1 cedula, 2 ruc, 3 pasaporte)
ref_cli_identificacion
string 
required
numero de identificacion del cliente
ref_cli_nombre
string 
required
nombre del cliente
ref_cli_celular
string 
optional
numero celular del cliente
ref_cli_telefono
string 
optional
numero de telefono del cliente
ref_cli_mail
string 
optional
correo electronico del cliente
ref_cli_calle_principal
string 
required
calle princiapl del cliente
ref_cli_calle_secundaria
string 
optional
calle secundaria del cliente
ref_cli_ciudad_id
string 
required
codigo que se reporta al SRI de la tabla de ubicaciones, 0101 Que es Azuay, es los mismo codigos que se manejan en la dinardaf
ref_cli_ciudad
string 
required
nombre de la ciudad a la que pertenece el cliente
ref_cli_fecha_creacion
string 
required
fecha de creacion del cliente.
ref_ventas
array [object {59}] 
optional
Examples

Responses

🟢200Datos Venta (200 OK)
application/json
Body
empresa
string 
required
fecha_datos
string 
required
total_registros
integer 
required
suma_total
number 
required
errores
array[string]
required
🔴500Datos Venta (500 ISE)
Modified at 2025-05-29 17:52:08
Previous
Estado Financiero V2
Next
Datos Venta V4
Built with