Skip to content

Comando emitir

Genera un nuevo comprobante, ya sea factura, boleta, o sus notas correspondientes.

Parámetros

modo_prueba : Opcional. Booleano. Cuando es 'verdadero', genera un "dry run" del sistema, usando el servidor de pruebas de la SUNAT. Los nuevos clientes siempre tendrán este parámetro activo hasta que manualmente se active el modo 'producción'.

envio_inmediato : Opcional. Booleano. Cuando es 'verdadero', envía los documentos a la SUNAT inmediatamente, esperando la respuesta de los mismos. Siempre activo cuando modo_prueba está activo.

codigo_establecimiento : Opcional. Numérico. Código del establecimiento asignado por la SUNAT del establecimiento donde se está realizando la venta de bienes.

Si la venta se realiza en el domicilio fiscal, o si no puede determinarse el lugar de la venta, consignar "0".

Si se omite, se usará el código '0'.

tipo : Requerido. 1 carácter. Define el tipo de comprobante a generar:

  • f: Factura
  • b: Boleta de venta
  • c: Nota de crédito
  • d: Nota de débito

tipo_operacion : Opcional. Numérico. Para facturas y boletas, código de la operación que realiza esta venta. Los valores pueden ser:

  • 101: Venta interna
  • 102: Exportación
  • 103: No domicilados
  • 104: Venta interna – anticipos
  • 105: Venta itinerante
  • 106: Factura guía
  • 107: Venta arroz pilado
  • 108: Factura comprobante de percepción
  • 110: Factura - guía remitente

Si se omite, se usará el código 101 (Venta interna)

documento_modificado : Opcional. Usado sólo para las notas, máximo 13 caracteres. Número y serie (incluyendo el guión) de la factura o boleta afectada por la nota.

tipo_nota : Opcional. Usado sólo para las notas, 1 carácter. Motivo por el cual se está creando la nota:

  • Para notas de crédito:
    • 1: Anulación de la operación
    • 2: Anulación por error en el RUC
    • 3: Corrección por error en la descripción
    • 4: Descuento global
    • 5: Descuento por item
    • 6: Devolución total
    • 7: Devolución parcial
    • 8: Bonificación
    • 9: Disminución en el valor
  • Para notas de débito:
    • 1: Intereses por mora
    • 2: Aumento de valor

serie : Requerido. Hasta 4 caracteres. Serie del documento. Debe empezar con 'F' para facturas y sus notas, y con 'B' para las boletas de venta y sus notas.

numero : Requerido. Hasta 8 dígitos. Número correlativo del documento.

tipo_doc : Requerido. Un caracter. Tipo de documento del receptor del comprobante:

  • r: RUC
  • d: DNI
  • x: Carné de extranjería
  • p: Pasaporte
  • c: Cédula diplomática
  • n: No domiciliado sin RUC
  • -: No especificado, sólo usado en boletas que no requieran documento de identidad.

numero_doc : Requerido. Hasta 14 caracteres. Número del documento de identidad del receptor del comprobante. Para boletas que no requieran, se puede consignar un guión.

razon_social : Requerido. Hasta 100 caracteres. Nombre completo o razón social del receptor del comprobante. Para boletas que no requieran, se puede consignar un guión ("-").

direccion : Opcional. Hasta 100 caracteres. Dirección fiscal del receptor del comprobante. Para boletas que no requieran, se puede consignar un guión ("-").

fecha : Requerido. Fecha de emisión del comprobante.

hora : Opcional. Hora de emisión del comprobante. Debe consignarse en formato 24 horas, y puede omitirse los segundos (en tal caso, se usará 0 segundos)

  • HH:MM
  • HH:MM:SS
  • HH:MM:SS.SSSS

De omitirse, se usará la hora cuando el comprobante es recibido por el facturador.

fecha_vencimiento : Opcional. Fecha de vencimiento del comprobante.

moneda : Requerido. 3 caracteres. Denominación ISO4217 de la moneda del comprobante. E.g. 'PEN' para Soles Peruanos, o 'USD' para Dólar Estadounidense.

observaciones : Opcional. Obligatorio para notas, indica el motivo de la emisiòn de la nota. Para facturas o boletas de venta, texto que serà añadido a la representaciòn impresa.

monto_detraccion : Opcional. Decimal. Monto total de la detracción.

porcentaje_detraccion : Opcional. Entero. Porcentaje de detracción aplicado al total del CPE

codigo_detraccion : Opcional. Obligatorio si está definido monto_detraccion, entero. Código del bien o servicio afectado por la detracción, como detalla el Catálogo No. 54: Códigos de bienes y servicios sujetos a detracción.

forma_pago_detraccion : Opcional. Opcional si está definido monto_detraccion, entero. Código de la forma de pago de la detracción, según indica el Catálogo No. 59: Medios de Pago. De omitirse, se userá el valor '001'

porcentaje_igv : Opcional. Entero. Porcentaje de referencia del IGV. No usado en cálculos. Si se omite, se mostrará el valor legal actual en la representación impresa.

monto_icbper : Opcional. Decimal. Monto del ICBPER a aplicar a cada item marcado con bolsa_plastico, en la moneda del documento. Si se omite. se usará el valor legal del impuesto en la fecha de recepción del comprubante, en soles.

leyendas : Opcional. [nuevo] Colección. Para facturas o boletas, mensajes que deben formar parte del comprobante de pago, acorde con lo regulado por el Reglamento de comprobantes de pago u otras disposiciones, que buscan diferenciar operaciones y/o agregar información complementaria al documento.

descuento_global : Opcional. [nuevo] Numérico. Descuento global, que ha sido aplicado al total del comprobante. Este descuento es distinto al que pueda ser aplicado a cada ítem del mismo.

Los totales gravado, inafecto y exonerado ya deben incluir este descuento global.

base_descuento_global : Opcional. [nuevo] Numérico. Monto base al cual se le ha aplicado el descuento global. Es la suma de todos los totales sin incluir el descuento global.

total_gravado : Opcional. Numérico. Incluye descuentos globales.

total_inafecto : Opcional. Numérico. Incluye descuentos globales.

total_exonerado : Opcional. Numérico. Incluye descuentos globales.

total_gratuito : Opcional. Numérico. Suma de precios de referencia de items gratuitos.

total_descuentos : Opcional. Numérico. Suma de descuentos por ítem, más descuentos globales.

total_igv : Opcional. Numérico. Total de impuesto general a las ventas del comprobante.

recibir_codigo_barras : Opcional. Cadena de caracteres. Añade a la respuesta de la API el tipo de código de barras 2D solicitado, en formato PNG. Al 9 de marzo del 2018, el único valor aceptado para esta propiedad es 'qr'. También se puede usar como valor la palabra 'legal', que devuelve siempre el código de barras legalmente requerido a la fecha.

recibir_valor_firma : Opcional. Booleano. Añade a la respuesta el valor de la firma digital. Solía usarse para generar el código de barras, pero ahora se usa el valor resumen.

recibir_enlaces : Opcional. Booleano. Añade a la respuesta la URL completa para descargar la representacion impresa del comprobante, así como su XML y su comprobante de recepción, en los campos pdf, xml y cdr, respectivamente.

enviar_correo : Opcional. Colección, opcional. Envía un correo electrónico con el comprobante a todas las direcciones especificadas en esta propiedad.

Ver documentación de la colección de destinatarios de correo.

item : Requerido. Colección de los items que componen este comprobante. Ver documentación.

Valores de retorno

codigo_documento : Código con fomato de la SUNAT del comprobante.

codigo_descarga : Código que será usado para formar la URL de descarga de los documentos.