Facturas Electrónicas

CABECERA DEL DOCUMENTO

ATRIBUTO	VALOR	TIPO DE DATO	REQUISITO	LONGITUD
Operación	Este valor siempre deberá ser "generar_comprobante" para enviar FACTURAS, BOLETAS, NOTAS DE CRÉDITO o DÉBITO	String	Obligatorio	11 exactos
tipo_de_comprobante	Tipo de COMPROBANTE que desea generar: 1 = FACTURA 2 = BOLETA 3 = NOTA DE CRÉDITO 4 = NOTA DE DÉBITO	Integer	Obligatorio	1 exacto
Serie	Empieza con "F" para FACTURAS y NOTAS ASOCIADAS. Empieza con "B" para BOLETAS DE VENTA y NOTAS ASOCIADAS Si está comunicando un comprobante emitido en contingencia, la serie debe empezar NO debe empezar con "F" ni con "B". Debería empezar con "0", ejemplo: "0001"	String	Obligatorio	4 exactos
Número	Número correlativo del documento, sin ceros a la izquierd	Integer	Obligatorio	1 hasta 8
sunat_transaction	La mayoría de veces se usa el 1, las demás son para tipos de operaciones muy especiales, no dudes en consultar con nosotros para más información: 1 = VENTA INTERNA 2 = ANTICIPO O DEDUCCIÓN DE ANTICIPO EN VENTA INTERNA 3 = EXPORTACIÓN 4=VENTAS NO DOMICILIADOS QUE NO CALIFICAN COMO EXPORTACIÓN 6 = OPERACIÓN SUJETA A DETRACCIÓN	Integer	Obligatorio	1 hasta 2
cliente_tipo_de_documento	6 = RUC - REGISTRO ÚNICO DE CONTRIBUYENTE 1 = DNI - DOC. NACIONAL DE IDENTIDAD -= VARIOS - VENTAS MENORES A S/.700.00 Y OTROS 4 = CARNET DE EXTRANJERÍA 7 = PASAPORTE 0 = NO DOMICILIADO, SIN RUC (EXPORTACIÓN)	String	Obligatorio	1 exacto
cliente_numero_de_documento	Ejemplo: RUC del CLIENTE, número de DNI, Etc.	String	Obligatorio	1 hasta 15
cliente_denominacion	Razón o nombre completo del CLIENTE.	String	Obligatorio	1 hasta 100
cliente_direccion	Dirección completa (OPCIONAL en caso de ser una BOLETA DE VENTA o NOTA ASOCIADA).	String	Obligatorio	1 hasta 100
cliente_email	Dirección de email debe ser válido.	String	Opcional	1 hasta 250
cliente_email_1	Dirección de email debe ser válido.	String	Opcional	1 hasta 250
fecha_de_emision	Debe ser la fecha actual. Formato AAAA-MM-DD Ejemplo: 2021-04-27	Date	Obligatorio	10 exactos
fecha_de_vencimiento	Deber ser fecha posterior a la fecha de emisión Formato AAAA-MM-DD Ejemplo: 2021-04-27	Date	Opcional	10 exactos
Moneda	De necesitar más monedas no dude en contactarse con nosotros. 1 = SOLES" 2 = DÓLARES" 3 = EUROS"	Integer	Obligatorio	1 exacto
tipo_de_cambio	Ejemplo: 3.421	Numeric	Condicional	1 entero con 3 decimales
porcentaje_de_igv	Porcentajes Permitidos: 10.00 - 18.00 Ejemplo: 18.00	Numeric	Obligatorio	1 hasta 2 enteros con 2 decimales
total_descuento	Ejemplo: 1305.05	Numeric	Condicional	1 hasta 12 enteros con 2 decimales
total_anticipo	Ejemplo: 1305.05	Numeric	Condicional	1 hasta 12 enteros con 2 decimales
total_gravada	Ejemplo: 1305.05	Numeric	Condicional	1 hasta 12 enteros con 2 decimales
total_inafecta	Ejemplo: 1305.05	Numeric	Condicional	1 hasta 12 enteros con 2 decimales
total_exonerada	Ejemplo: 1305.05	Numeric	Condicional	1 hasta 12 enteros con 2 decimales
otal_igv	Ejemplo: 1305.05	Numeric	Condicional	1 hasta 12 enteros con 2 decimales
total_gratuita	Ejemplo: 1305.05	Numeric	Condicional	1 hasta 12 enteros con 2 decimales
total_otros_cargos	Ejemplo: 1305.05	Numeric	Condicional	1 hasta 12 enteros con 2 decimales
total	Ejemplo: 1305.05	Numeric	Obligatorio	1 hasta 12 enteros con 2 decimales
total_impuestos_bolsas	Ejemplo: 0.10	Numeric	Condicional	1 hasta 12 enteros con 2 decimales
Detracción	false = FALSO (En minúsculas) true = VERDADERO (En minúsculas)	Boolean	Condicional	Hasta 5
Observaciones	Texto de 0 hasta 1000 caracteres. Si se desea saltos de línea para la representación impresa o PDF usar <br>. Ejemplo: XXXXX <br> YYYYYY	Text	Opcional	Hasta 5
documento_que_se_modifica_tipo	1 = FACTURAS ELECTRÓNICAS 2 = BOLETAS DE VENTA ELECTRÓNICAS	Integer	Condicional	1 exacto
documento_que_se_modifica_serie	SERIE de la FACTURA o BOLETA que se modifica (previamente comunicado)	String	Condicional	4 exactos
documento_que_se_modifica_numero	NÚMERO de la FACTURA o BOLETA que se modifica (previamente comunicado)	Integer	Condicional	1 hasta 8
tipo_de_nota_de_credito	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 ÍTEM 6 = DEVOLUCIÓN TOTAL 7 = DEVOLUCIÓN POR ÍTEM 8 = BONIFICACIÓN 9 = DISMINUCIÓN EN EL VALOR 10= OTROS CONCEPTOS	Integer	Condicional	1 hasta 2
tipo_de_nota_de_debito	1 = INTERESES POR MORA 2 = AUMENTO DE VALOR 3 = PENALIDADES 4= AJUSTES AFECTOS AL IVAP 5 = AJUSTES DE OPERACIONES DE EXPORTACIÓN	Integer	Condicional	1 exacto
enviar_automaticamente_al_cliente	false = FALSO (En minúsculas) true = VERDADERO (En minúsculas)	Boolean	Condicional	Hasta 5
condiciones_de_pago	CONTADO CREDITO TRANSFERENCIA TARJETA	String	Obligatorio	1 hasta 250
medio_de_pago	Si la condición de pago es transferencia: BCP INTERBANK BANCO DE LA NACION BBVA MERCADO LIBRE YAPE PLIN	String	Opcional	1 hasta 250
formato_de_pdf	Formato de PDF que se desea generar para la representación. Se puede elegir entre A4, A5 o TICKET.	String	Obligatorio	2 hasta 5
generado_por_contingencia	Si está comunicando un comprobante emitido en contingencia debería ser “true” (en minúsculas).	Boolean	Obligatorio	Hasta 5
bienes_region_selva	Si el producto es un bien de la región selva debería ser “true”	Boolean	Obligatorio	Hasta 5
servicios_region_selva	Si el producto es un servicio de la región selva debería ser “true”	Boolean	Obligatorio	Hasta 5
items	Permite items anidados, se refiere a los ITEMS o LÍNEAS del comprobante, el detalle en un cuadro más abajo.	-	-	-
guias	Permite guias anidadas, se refiere a los ITEMS o LÍNEAS del comprobante, el detalle en un cuadro más abajo.	-	-	-
venta_al_credito	Permite venta_al_credito anidadas, se refiere a los ITEMS o LÍNEAS del comprobante, el detalle en un cuadro más abajo.	-	-	-

PARA ITEMS O LÍNEAS DEL DOCUMENTO

ATRIBUTO	VALOR	TIPO DE DATO	REQUISITO	LONGITUD
unidad_de_medida	NIU = PRODUCTO ZZ = SERVICIO Si necesitas más unidades de medida, debes crearlas primeramente en tu cuenta de GYOMANAGER para que estén disponibles	String	Obligatorio	2 hasta 5
codigo	Código interno del producto o servicio, asignado por ti. Ejemplo: C01	String	Opcional	1 hasta 250
descripcion	Descripción del producto o servicio. Ejemplo: SERVICIO DE REPARACIÓN DE PC, ETC.	Text	Obligatorio	1 hasta 250
cantidad	Ejemplo: 1.215	Numeric	Obligatorio	1 hasta 12 enteros, hasta con 10 decimales
valor_unitario	Sin IGV. Ejemplo: 90.215691372	Numeric	Obligatorio	1 hasta 12 enteros, hasta con 10 decimales
precio_unitario	Con IGV. Ejemplo: 233.215691372	Numeric	Obligatorio	1 hasta 12 enteros, hasta con 10 decimales
subtotal	Resultado de VALOR UNITARIO por la CANTIDAD menos el DESCUENTO	Numeric	Obligatorio	1 hasta 12 enteros, hasta con 2 decimales
tipo_de_igv	1 = Gravado - Operación Onerosa 2 = Gravado – Retiro por premio 3 = Gravado – Retiro por donación 4 = Gravado – Retiro 5 = Gravado – Retiro por publicidad 6 = Gravado – Bonificaciones 7 = Gravado – Retiro por entrega a trabajadores 8 = Exonerado - Operación Onerosa 9 = Inafecto - Operación Onerosa 10 = Inafecto – Retiro por Bonificación 11 = Inafecto – Retiro 12 = Inafecto – Retiro por Muestras Médicas 13 = Inafecto - Retiro por Convenio Colectivo 14 = Inafecto – Retiro por premio 15 = Inafecto - Retiro por publicidad 16 = Exportación 17 = Exonerado - Transferencia Gratuita	Integer	Obligatorio	1 hasta 2 enteros
igv	Total del IGV de la línea	Numeric	Obligatorio	1 hasta 12 enteros, hasta con 2 decimales
total	Total de la línea	Numeric	Obligatorio	1 hasta 12 enteros, hasta con 2 decimales

PARA GUÍAS

ATRIBUTO	DESCRIPCIÓN	TIPO DE DATO	REQUISITO	LONGITUD
guia_tipo	Tipo de la GUÍA DE REMISIÓN RELACIONADA. Ejemplo: 1 1 = GUÍA DE REMISIÓN REMITENTE 2 = GUÍA DE REMISIÓN TRANSPORTISTA	Integer	Opcional	1 exacto
guia_serie_numero	Serie y número de la GUÍA DE REMISIÓN RELACIONADA separado con un guión medio. Ejemplo: 0322-1	String	Opcional	1 hasta 30

PARA VENTAS AL CRÉDITO

ATRIBUTO	DESCRIPCIÓN	TIPO DE DATO	REQUISITO	LONGITUD
fecha_de_pago	Debe ser la fecha actual. Formato AAAA-MM-DD Ejemplo: 2021-04-27	Date	Obligatorio	10 exactos
importe	Importe de Cuota	Numeric	Obligatorio	1 hasta 12 enteros, hasta con 2 decimales

Datos para Detracciones

Tipo de Detracción

1	Azúcar y melaza de caña
2	Arroz
3	Alcohol etílico
4	Recursos hidrobiológicos
5	Maíz amarillo duro
6	Caña de azúcar
7	Madera
8	Arena y piedra.
9	Residuos, subproductos, desechos, recortes y despe...
10	Bienes gravados con el IGV, o renuncia a la exoner...
11	Intermediación laboral y tercerización
12	Animales vivos
13	Carnes y despojos comestibles
14	Abonos, cueros y pieles de origen animal
15	Harina, polvo y “pellets” de pescado, crustáceos, ...
16	Arrendamiento de bienes muebles
17	Mantenimiento y reparación de bienes muebles
18	Movimiento de carga
19	Otros servicios empresariales
20	Leche
21	Comisión mercantil
22	Fabricación de bienes por encargo
23	Servicio de transporte de personas
24	Servicio de transporte de carga
25	Transporte de pasajeros
26	Contratos de construcción
27	Oro gravado con el IGV
28	Paprika y otros frutos de los generos capsicum o p...
29	Minerales metálicos no auríferos
30	Bienes exonerados del IGV
31	Oro y demás minerales metálicos exonerados del IGV
32	Demás servicios gravados con el IGV
33	Minerales no metálicos
34	Bien inmueble gravado con IGV
35	Plomo
36	Ley 30737
37	Aceite de pescado

Métodos de Pago

1	Depósito en cuenta
2	Giro
3	Transferencia de fondos
4	Orden de pago
5	Tarjeta de débito
6	Tarjeta de crédito emitida en el país por una empresa del sistema financiero
7	Cheques con la cláusula de "NO NEGOCIABLE", "INTRANSFERIBLES", "NO A LA ORDEN" u otra equivalente, a que se refiere el i
8	Efectivo, por operaciones en las que no existe obligación de utilizar medio de pago
9	Efectivo, en los demás casos
10	Medios de pago usados en comercio exterior
11	Documentos emitidos por las EDPYMES y las cooperativas de ahorro y crédito no autorizadas a captar depósitos del público
12	Tarjeta de crédito emitida en el país o en el exterior por una empresa no perteneciente al sistema financiero, cuyo obje
13	Tarjetas de crédito emitidas en el exterior por empresas bancarias o financieras no domiciliadas
14	Transferencias – Comercio exterior
15	Cheques bancarios - Comercio exterior
16	Orden de pago simple - Comercio exterior
17	Orden de pago documentario - Comercio exterior
18	Remesa simple - Comercio exterior
19	Remesa documentaria - Comercio exterior
20	Carta de crédito simple - Comercio exterior
21	Carta de crédito documentario - Comercio exterior
22	Otros medios de pago

Ejemplo de Factura electrónica

{
   "operacion": "generar_comprobante",
   "tipo_de_comprobante": "1",
   "serie": "F001",
   "numero": 769,
   "sunat_transaction": 1,
   "cliente_tipo_de_documento": 6,
   "cliente_numero_de_documento": "20536161199",
   "cliente_denominacion": "GOOGLE PERU S.R.L.",
   "cliente_direccion": "AV. LA PAZ NRO. 1049 URB. LEURO - LIMA LIMA MIRAFLORES",
   "cliente_email": "",
   "cliente_email_1": "",
   "cliente_email_2": "",
   "fecha_de_emision": "05-07-2021",
   "fecha_de_vencimiento": "",
   "moneda": "1",
   "tipo_de_cambio": "",
   "porcentaje_de_igv": 18.00,
   "descuento_global": "",
   "total_descuento": "",
   "total_anticipo": "",
   "total_gravada": "156.36",
   "total_inafecta": "",
   "total_exonerada": "",
   "total_igv": 28.14,
   "total_gratuita": "",
   "total_otros_cargos": "",
   "total": "184.50",
   "detraccion": "false",
   "observaciones": "EJEMPLO JSON GENERAR CPE",
   "documento_que_se_modifica_tipo": "",
   "documento_que_se_modifica_serie": "",
   "documento_que_se_modifica_numero": "",
   "tipo_de_nota_de_credito": "",
   "tipo_de_nota_de_debito": "",
   "enviar_automaticamente_a_la_sunat": "true",
   "enviar_automaticamente_al_cliente": "false",
   "codigo_unico": "",
   "condiciones_de_pago": "CONTADO",
   "medio_de_pago": "",
   "placa_vehiculo": "",
   "orden_compra_servicio": "",
   "tabla_personalizada_codigo": "",
   "formato_de_pdf": "",
   "detraccion_info": {
        "tipo_detraccion": "7",
        "metodo_pago": "1",
        "cuenta_detracciones": "00-0033456",
        "porcentaje": 4, // En enteros. Sin %
        "total_detraccion": 10.0 // en soles
   },
   "items": [
         {
            "unidad_de_medida": "NIU",
            "codigo": "001",
            "descripcion": "DETALLE DEL PRODUCTO",
            "cantidad": "1",
            "valor_unitario": "156.3559322034",
            "precio_unitario": "184.50",
            "descuento": "",
            "subtotal": "156.36",
            "tipo_de_igv": "1",
            "igv": "28.14",
            "total": "184.50",
            "anticipo_regularizacion": "false",
            "anticipo_documento_serie": "",
            "anticipo_documento_numero": "",
            "codigo_producto_sunat": "10000000"
         }
   ]
}

Ejemplo de Respuesta

{
    "success": true,
    "tipo_de_comprobante": "01",
    "serie": "F001",
    "numero": "00001390",
    "key": "948d7232-3227-4364-9d10-fabace528e78",
    "digest_value": "OHLOh+Jn6ZznohEz0tLDDBwzmeE=",
    "enlace": "https://gyomanager.com/comprobante/948d8232-3227-4364-9d10-fabace528e78+01",
    "enlace_del_pdf": "https://gyomanager.com/comprobante/948d8232-3227-4364-9d10-fabace528e78+01.pdf",
    "enlace_del_xml": "https://gyomanager.com/comprobante/948d8232-3227-4364-9d10-fabace528e78+01.xml",
    "enlace_del_cdr": "https://gyomanager.com/comprobante/948d8232-3227-4364-9d10-fabace528e78+01.cdr",
    "aceptada_por_sunat": true,
    "sunat_responsecode": "0",
    "sunat_description": "La Factura numero F001-00001390, ha sido aceptada",
    "sunat_status": "ACEPTADO", // NO CONSULTADO - ANULADO - NO EXISTE
    "cadena_para_codigo_qr": "10701364541|01|F001|00001390|28.14|184.50|2022-02-03|6|20536161199|OHLOh+Jn6ZznohEz0tLDDBwzmeE=",
    "codigo_hash": "OHLOh+Jn6ZznohEz0tLDDBwzmeE=",
    "sunat_soap_error": "[]"
}