Generador - ContawebAyM API
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
http://contawebaym.com:7060/api/v1/generarDEXMLV21

Autorización Requerida

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

Estructura del Payload (JSON)

El envío de un comprobante a SUNAT requiere más de 60 parámetros en total. Para facilitar su comprensión, los hemos agrupado lógicamente. Todos los campos pertenecen al objeto cab a menos que se indique que son arreglos (items o cuotas).

1. Datos del Documento (Cabecera)

Campo Descripción
cab.docu_tipodocumento Código SUNAT del comprobante. Los más comunes son:
  • 01: Factura
  • 03: Boleta de Venta
  • 07: Nota de Crédito
  • 08: Nota de Débito
cab.docu_serie Serie del comprobante (Ej. F001, BB04).
cab.docu_numero Correlativo del documento (Ej. 00002816).
cab.docu_fecha_emision Fecha en formato YYYY-MM-DD.
cab.docu_moneda Código internacional (PEN, USD).

2. Datos de Emisor y Cliente

Campo Descripción
cab.empr_nroruc RUC de la empresa emisora.
cab.clie_tipodoc Tipo de documento del cliente (Ej. 1=DNI, 6=RUC).
cab.clie_numero Número de documento del cliente.

3. Importes y Totales

cab.docu_total_gravada Sumatoria de ítems gravados con IGV.
cab.docu_total_exonerada Sumatoria de ítems exonerados (Ej. tipo 20).
cab.docu_total_igv Monto total del IGV calculado.
cab.docu_total Monto final a cobrar. Debe cuadrar con la suma de gravada + inafecta + exonerada + IGV + cargos.

4. Arrays de Detalle

items [ ] Arreglo de productos/servicios. Cada objeto debe incluir: item_unidad_medida (Ej. NIU), item_cantidad, item_valor_unitario y item_tipo_igv.
*Nota: Si el ítem es exonerado, el tipo de IGV suele ser "20".
cuotas [ ] Define la forma de pago (Contado o a crédito con sus respectivas cuotas).

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": "03",
    "docu_fecha_emision": "2026-06-23",
    "docu_hora_emision": "18:05:11",
    "docu_serie": "BB04",
    "docu_numero": "00002816",
    "sunatTrans": "1",
    "docu_fecha_venc": "2026-06-23",
    "docu_moneda": "PEN",
    "docu_tipo_cambio": "1.000",
    "docu_porc_igv": "0.18",
    "docu_dscto_global": "0.00",
    "docu_total_anticipo": "0",
    "docu_total_gravada": "0.00",
    "docu_total_inafecta": "0.00",
    "docu_total_exonerada": "150.00",
    "docu_total_igv": "0.00",
    "docu_total_gratuita": "0.00",
    "docu_total_otros_cargos": "0.00",
    "docu_total_otros_atrib": "0.00",
    "docu_total": "150.00",
    "docu_tipo_percep": "",
    "docu_total_percepcion": "",
    "docu_mot_dcto": "00",
    "docu_observaciones": "",
    "enviarSunat": "1",
    "enviarCorreoCliente": "0",
    "ambSunat": "4",
    "clie_numero": "47730675",
    "clie_tipodoc": "1",
    "clie_nombre": "ORTEGA RAMOS RAUL REYNALDO",
    "clie_direccion": "",
    "empr_razonsocial": "INVERSIONES PIANDA S.A.C.",
    "empr_nombrecomercial": "AP Games",
    "empr_direccion": "Av. Paseo de la Republica Nro. 475 Int. 13",
    "empr_provincia": "LIMA",
    "empr_departamento": "LIMA",
    "empr_distrito": "La Victoria",
    "empr_pais": "PE",
    "empr_nroruc": "20609359651",
    "empr_tipodoc": "6",
    "empr_codEstb": "0000",
    "formaPago": "1",
    "tipo_oper_cw": "1",
    "validacionIgv": "18.00",
    "validacionGratuita": "0"
  },
  "items": [
    {
      "cod_item": "1",
      "item_unidad_medida": "NIU",
      "item_codigo": "045496905019",
      "item_descr": "SW DONKEY KONG RETURN HD",
      "item_cantidad": "1.00",
      "item_valor_unitario": "150.0000000000",
      "item_precio_unitario": "150.00",
      "item_pnohonerosa": "0.00",
      "item_subTota": "150.00",
      "item_tipo_igv": "20",
      "item_igv": "0.00",
      "item_total": "150.00",
      "item_antic_regula": "0",
      "item_tasa_igv": "0.18",
      "item_name_short": "",
      "item_precio_descr": "1",
      "item_moneda_descr": "20",
      "item_name_marca": "",
      "item_inclu_igv": "false",
      "item_igv_unitario": "0.00",
      "item_total_neto": "150.00",
      "item_indicator": "20",
      "item_dcto": "150.00",
      "item_dcto_igv": "0.00",
      "item_dcto_total": "0.00",
      "item_impor_dcto": "0.00",
      "item_cod_cargodescuento": "",
      "item_multiplicador_descuento": "0.00",
      "item_indicador_cargodescuento": "false",
      "item_valor_base": "150.0000000000",
      "item_valor_base_cantidad": "150.00"
    }
  ],
  "cuotas": [
    {
      "formaPagoID": "FormaPago",
      "tipoFormaPaymentID": "Contado",
      "amountID": "150.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.