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

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Examples

Responses

🟢200Datos Venta V4 (200 OK)
application/json
Body

🟢200Datos Venta V4 (500 ISE)
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://apicorporativo.curbe.com.ec/api/ventas' \
--header 'Authorization: Bearer <token>' \
--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":[]
}
Modified at 2025-05-29 17:52:13
Previous
Datos Venta
Next
INGRESO DE DATOS DE CARTERA
Built with