Notas de Débito
CABECERA DEL DOCUMENTO
Operación
Este valor siempre deberá ser "generar_comprobante" para enviar FACTURAS, BOLETAS, NOTAS DE CRÉDITO o DÉBITO
String
Obligatorio
11 exactos
tiptipo_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
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
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
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
Ejemplos de Notas de Débito
{
"success": true,
"operacion": "generar_comprobante",
"tipo_de_comprobante": 4,
"serie": "F001",
"numero": "5",
"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": "",
"cliente_email_1": "",
"cliente_email_2": "",
"fecha_de_emision": "23-04-2021",
"fecha_de_vencimiento": "",
"moneda": "1",
"tipo_de_cambio": "",
"porcentaje_de_igv": 18.00,
"descuento_global": "",
"total_descuento": "",
"total_anticipo": "",
"total_gravada": "600",
"total_inafecta": "",
"total_exonerada": "",
"total_igv": "108",
"total_gratuita": "",
"total_otros_cargos": "",
"total": "708",
"percepcion_tipo": "",
"percepcion_base_imponible": "",
"total_percepcion": "",
"total_incluido_percepcion": "",
"detraccion": "false",
"observaciones": "EJEMPLO JSON - GENERAR CPE NOTA DEBITO 1 PARA FACTURA",
"documento_que_se_modifica_tipo": 1,
"documento_que_se_modifica_serie": "FFF1",
"documento_que_se_modifica_numero": 1,
"tipo_de_nota_de_credito": "",
"tipo_de_nota_de_debito": 1,
"enviar_automaticamente_a_la_sunat": "true",
"enviar_automaticamente_al_cliente": "false",
"codigo_unico": "",
"condiciones_de_pago": "",
"medio_de_pago": "",
"placa_vehiculo": "",
"orden_compra_servicio": "",
"tabla_personalizada_codigo": "",
"formato_de_pdf": "",
"items": [
{
"unidad_de_medida": "NIU",
"codigo": "001",
"descripcion": "DETALLE DEL PRODUCTO",
"cantidad": "1",
"valor_unitario": "500",
"precio_unitario": "590",
"descuento": "",
"subtotal": "500",
"tipo_de_igv": "1",
"igv": "90",
"total": "590",
"anticipo_regularizacion": "false",
"anticipo_documento_serie": "",
"anticipo_documento_numero": "",
"codigo_producto_sunat": "10000000"
},
{
"unidad_de_medida": "ZZ",
"codigo": "001",
"descripcion": "DETALLE DEL SERVICIO",
"cantidad": "5",
"valor_unitario": "20",
"precio_unitario": "23.60",
"descuento": "",
"subtotal": "100",
"tipo_de_igv": "1",
"igv": "18",
"total": "118",
"anticipo_regularizacion": "false",
"anticipo_documento_serie": "",
"anticipo_documento_numero": "",
"codigo_producto_sunat": "20000000"
}
]
}
Ejemplo de Respuesta
{
"success": true,
"tipo_de_comprobante": "08",
"serie": "F001",
"numero": "00000100",
"key": "71eab203-c46a-4871-aca3-343b941ed1af",
"digest_value": "IbpC0KQdz4nakBgq5o1oBh4MA4Q=",
"enlace": "http://gyomanager.com/comprobante/71eab203-c46a-4871-aca3-343b941ed1af+08",
"enlace_del_pdf": "http://gyomanager.com/comprobante/71eab203-c46a-4871-aca3-343b941ed1af+08.pdf",
"enlace_del_xml": "http://gyomanager.com/comprobante/71eab203-c46a-4871-aca3-343b941ed1af+08.xml",
"enlace_del_cdr": "http://gyomanager.com/comprobante/71eab203-c46a-4871-aca3-343b941ed1af+08.cdr",
"aceptada_por_sunat": true,
"sunat_responsecode": "0",
"sunat_description": "La Nota de Debito numero F001-00000100, ha sido aceptada",
"cadena_para_codigo_qr": "10701364541|08|F001|00000100|108.00|708.00|2021-04-23|6|20603289324|IbpC0KQdz4nakBgq5o1oBh4MA4Q=",
"codigo_hash": "IbpC0KQdz4nakBgq5o1oBh4MA4Q=",
"sunat_soap_error": "[]"
}Last updated