API Docs

Generador de Facturación

Bienvenido a la sección del Generador. Este endpoint te permite crear, firmar y enviar un comprobante electrónico (Factura, Boleta, etc.) directo a la SUNAT de forma automática.

Endpoint de Generación

POST
https://contawebaym.com/v1/facturacion/generar

Autorización Requerida

Esta petición requiere autenticación. Debes incluir tu token JWT en los Headers usando la clave token.

Parámetros principales

Campo Tipo Descripción
cab.tipo_oper String Código del tipo de operación (Ej. 0101 Venta interna).
cab.docu_fecha_emision String Fecha de emisión del comprobante (YYYY-MM-DD).
cab.docu_moneda String Código de la moneda (ej. PEN, USD).
items Array Lista de productos o servicios (detalles del comprobante).
cuotas Array Manejo de cuotas (obligatorio si la forma de pago es crédito).

Ejemplo

El envío es simple, este es un ejemplo de la generación de una factura electrónica con sus respectivos items. 

{
  "cab": {
    "tipo_oper": "0101",
    "docu_tipodocumento": "01",
    "docu_fecha_emision": "2026-07-01",
    "docu_hora_emision": "09:30:00",
    "docu_serie": "F001",
    "docu_numero": "00001024",
    "docu_fecha_venc": "2026-07-15",
    "docu_moneda": "PEN",
    "docu_tipo_cambio": "3.850",
    "docu_porc_igv": "18.00",
    "docu_dscto_global": "0.00",
    "docu_total_anticipo": "0.00",
    "docu_total_gravada": "1000.00",
    "docu_total_inafecta": "0.00",
    "docu_total_exonerada": "0.00",
    "docu_total_igv": "180.00",
    "docu_total_gratuita": "0.00",
    "docu_total_otros_cargos": "0.00",
    "docu_total_otros_atrib": "0.00",
    "docu_total": "1180.00",
    "docu_tipo_percep": "",
    "docu_total_percepcion": "0.00",
    "docu_mot_dcto": "00",
    "docu_observaciones": "Servicio de desarrollo",
    "docu_guia_remision": "",
    "docu_orden_compra": "OC-9988",
    "enviarSunat": "1",
    "enviarCorreoCliente": "1",
    "ambSunat": "3",
    "clie_numero": "20102030405",
    "clie_tipodoc": "6",
    "clie_nombre": "INVERSIONES DE EJEMPLO S.A.C.",
    "clie_direccion": "AV. LOS PINOS 123",
    "empr_razonsocial": "MI EMPRESA S.A.C.",
    "empr_nombrecomercial": "MI EMPRESA S.A.C.",
    "empr_direccion": "AV. PRINCIPAL 456",
    "empr_provincia": "Lima",
    "empr_departamento": "Lima",
    "empr_distrito": "Miraflores",
    "empr_pais": "PE",
    "empr_nroruc": "20987654321",
    "empr_tipodoc": "6",
    "empr_codEstb": "0000",
    "formaPago": "1",
    "id_sucursal": "CT",
    "tipo_oper_cw": "1",
    "voucVAdicional1": "",
    "voucVAdicional2": "",
    "voucVAdicional3": "",
    "voucVAdicional4": "",
    "voucVAdicional5": "",
    "voucVAdicional6": "",
    "voucVAdicional7": "",
    "voucVAdicional8": "",
    "voucVAdicional9": "",
    "voucVAdicional10": "",
    "montoLetras": "MIL CIENTO OCHENTA Y 00/100 SOLES",
    "validacionIgv": "18.0",
    "lista_docRelacionado": [],
    "sunatTrans": "1",
    "validacionGratuita": "0",
    "icbper": "false"
  },
  "items": [
    {
      "cod_item": "1",
      "item_unidad_medida": "NIU",
      "item_codigo": "SERV-001",
      "item_descr": "Desarrollo de Software a Medida",
      "item_cantidad": "1.00000",
      "item_valor_unitario": "1000.0000000000",
      "item_precio_unitario": "1180.0000000000",
      "item_subTota": "1000.00",
      "item_tipo_igv": "10",
      "item_igv": "180.00",
      "item_total": "1180.00",
      "item_tasa_igv": "0.18",
      "item_precio_descr": "1",
      "item_moneda_descr": "10",
      "item_name_marca": "",
      "item_inclu_igv": "true",
      "item_igv_unitario": "180.00",
      "item_total_neto": "1180.00",
      "item_indicator": "10",
      "item_dcto": "1000.00",
      "item_dcto_igv": "180.00",
      "item_dcto_total": "180.00",
      "item_impor_dcto": "0",
      "item_cod_cargodescuento": "00",
      "item_multiplicador_descuento": "0",
      "item_indicador_cargodescuento": "false",
      "item_valor_base": "1000.000000",
      "item_valor_base_cantidad": "1000.00"
    }
  ],
  "cuotas": [
    {
      "formaPagoID": "FormaPago",
      "tipoFormaPaymentID": "Contado",
      "amountID": "1180.00"
    }
  ]
}

TIP

También puedes consultar nuestras preguntas frecuentes y listado de errores para saber el significado de cada código que responde la SUNAT y cómo manejar un documento rechazado u observado.