Boletas 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 izquierda	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 = EXPORTACION 4=VENTAS NO DOMICILIADOS QUE NO CALIFICAN COMO EXPORTACIÓ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
echa_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
total_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

TRIBUTO	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	2021-04-27 Date	Obligatorio	10 exactos
importe	Importe de Cuota	Numeric	Obligatorio	1 hasta 12 enteros, hasta con 2 decimales

Ejemplo de Boleta Electrónicas

{
    "operacion": "generar_comprobante",
    "tipo_de_comprobante": 2,
    "serie": "BBB1",
    "numero": 3,
    "sunat_transaction": 1,
    "cliente_tipo_de_documento": 6,
    "cliente_numero_de_documento": "20603289324",
    "cliente_denominacion": "GYOSOLUCIONES INFORMATICAS SAC",
    "cliente_direccion": "CALLE LIBERTAD 116 MIRAFLORES - LIMA - PERU",
    "cliente_email": "[e-mail]",
    "cliente_email_1": "",
    "fecha_de_emision": "2021-04-05",
    "fecha_de_vencimiento": "",
    "moneda": 1,
    "tipo_de_cambio": 10.2,
    "porcentaje_de_igv": 18.00,
    "descuento_global": "",
    "total_descuento": "102",
    "total_anticipo": "",
    "total_gravada": 600,
    "total_inafecta": "",
    "total_exonerada": "",
    "total_igv": 108,
    "total_gratuita": "",
    "total_otros_cargos": "",
    "total": 708,
    "total_impuestos_bolsas": "",
    "detraccion": false,
    "observaciones": " ",
    "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_al_cliente": false,
    "condiciones_de_pago": "CREDITO",
    "medio_de_pago": "",
    "formato_de_pdf": "A4",
    "generado_por_contingencia": false,
    "bienes_region_selva": false,
    "servicios_region_selva": false,
    "items": [
        {
            "unidad_de_medida": "NIU",
            "codigo": "001",
            "codigo_producto_sunat": "10000000",
            "descripcion": "DETALLE DEL PRODUCTO",
            "cantidad": 1,
            "valor_unitario": "500.00",
            "precio_unitario": "590.00",
            "subtotal": "500.00",
            "tipo_de_igv": 1,
            "igv": "90.00",
            "total": "590.00",
            "anticipo_regularizacion": false,
            "anticipo_documento_serie": "",
            "anticipo_documento_numero": ""
        },
        {
            "unidad_de_medida": "ZZ",
            "codigo": "001",
            "codigo_producto_sunat": "20000000",
            "descripcion": "DETALLE DEL SERVICIO",
            "cantidad": 5,
            "valor_unitario": "20.00",
            "precio_unitario": "23.60",
            "subtotal": "100.00",
            "tipo_de_igv": 1,
            "igv": "18.00",
            "total": "118.00",
            "anticipo_regularizacion": false,
            "anticipo_documento_serie": "",
            "anticipo_documento_numero": ""
        }
    ],
    "venta_al_credito": [
        {
            "fecha_de_pago": "05-07-2021",
            "importe": 500
        },
        {
            "fecha_de_pago": "11-04-2021",
            "importe": 200
        },
        {
            "fecha_de_pago": "11-05-2021",
            "importe": 8
        }
    ]
 
    "guias": [
        {
            "guia_tipo": 1,
            "guia_serie_numero": "0001-23"
        }
    ]
}

Ejemplo de Respuesta

{
    "success": true,
    "tipo_de_comprobante": "03",
    "serie": "B001",
    "numero": "00000090",
    "key": "5dafae18-65c1-428a-a6c1-2b6c043eb384",
    "digest_value": "1hn70wBkE8ysre26RonbFfd81xg=",
    "enlace": "https://gyomanager.com/comprobante/5daf2e18-65c1-428a-a6c1-2b6c043eb384+03",
    "enlace_del_pdf": "https://gyomanager.com/comprobante/5daf2e18-65c1-428a-a6c1-2b6c043eb384+03.pdf",
    "enlace_del_xml": "https://gyomanager.com/comprobante/5daf2e18-65c1-428a-a6c1-2b6c043eb384+03.xml",
    "enlace_del_cdr": "https://gyomanager.com/comprobante/5daf2e18-65c1-428a-a6c1-2b6c043eb384+03.cdr",
    "aceptada_por_sunat": true,
    "sunat_responsecode": "0",
    "sunat_description": "La Boleta numero B001-00000090, ha sido aceptada",
    "sunat_status": "ACEPTADO", // NO CONSULTADO - ANULADO - NO EXISTE
    "cadena_para_codigo_qr": "10701364541|03|B001|00000090|0.00|600.00|2021-02-03|1|41920371|1hn70wBkE8ysre26RonbFfd81xg=",
    "codigo_hash": "1hn70wBkE8ysre26RonbFfd81xg=",
    "sunat_soap_error": "[]"
}