BYH Consulting

1. Introducción

Bienvenido al manual de integración por Web Services (REST). Podrás emitir documentos de venta desde tu sistema enviándonos una trama JSON. Nosotros nos encargamos de generar el XML, firmarlo y enviarlo a SUNAT.

2. Endpoints y Construcción de URL

El acceso al recurso se realiza por medio del siguiente patrón:


URL := https://test.easyfact.pe/see/rest/<tipoDocumento>/6/<ruc>/<serieNumero>

La variable <tipoDocumento> se define según la siguiente tabla de la SUNAT:

Código	Descripción
01	Factura
03	Boleta
07	Nota de Crédito
08	Nota de Débito
09	Guía de remisión
20	Retención
40	Percepción

3. Autenticación

Para consumir los servicios REST se requiere el uso de Autenticación Básica (Basic Auth). Se deben enviar las credenciales en el encabezado (Header) HTTP.

Usuario: sfe@miEmpresa
Clave: 123456

4. Parámetros en la trama

Parámetro `declare`

0: Solo firma el comprobante de venta
1: Firma y declara asíncronamente
2: Firma y Declara síncronamente

Opción para las notificaciones por correo (`notification`)

0: No hay notificación
1: Notificación al emisor
2: Notificación al aceptado
3: Notificación al aceptado con CDR

5. Factura

5.1 Diccionario de datos

5.1.1 Cabecera

Atributo	Tipo	Comentario
1. Datos Generales
declare	String	Opcional
serieNumero	String	Ej. F001-000001
fechaEmision	String	Formato YYYY-MM-DD
tipoDocumento	String	01
tipoMoneda	String	PEN o USD
codigoTipoOperacion	String
serieNumeroGuia	String	Opcional
tipoDocumentoGuia	String	Opcional
2. Datos del Emisor
numeroDocIdentidadEmisor	String	RUC de 11 dígitos
tipoDocIdentidadEmisor	String	Siempre es 6
nombreComercialEmisor	String	Opcional
razonSocialEmisor	String	Opcional
ubigeoEmisor	String	Opcional
direccionEmisor	String	Opcional
urbanizacionEmisor	String	Opcional
departamentoEmisor	String	Opcional
provinciaEmisor	String	Opcional
distritoEmisor	String	Opcional
codigoPaisEmisor	String	Opcional
3. Datos del Receptor
numeroDocIdentidadReceptor	String	RUC de 11 dígitos
tipoDocIdentidadReceptor	String	Siempre es 6
razonSocialReceptor	String
4. Totales
importeTotal	String
totalOPGravadas	String
totalOPNoGravadas	String	Opcional
totalOPExoneradas	String	Opcional
totalDescuentos	String	Opcional
sumatoriaIGV	String
sumatoriaISC	String	Opcional
sumatoriaOtrosTributos	String	Opcional
descuentosGlobales	String	Opcional
sumatoriaOtrosCargos	String	Opcional
importeTotalVenta	String

5.1.2 Items

Atributo	Tipo	Comentario
ordenItem	String
unidadMedidaItem	String
cantidadItem	String
codigoProductoItem	String
descripcionItem	String
valorUnitarioSinIgv	String
precioUnitarioConIgv	String
codTipoPrecioVtaUnitarioItem	String
codigoAfectacionIGVItem	String
montoISCItem	String	Opcional
tipoSistemaISCItem	String	Opcional
montoReferenciaItem	String	Opcional
codigoTipoPrecioReferencial	String	Opcional
descuentoItem	String	Opcional
valorVentaItem	String

5.1.3 Adicionales

Atributo	Tipo	Comentario
clave	String	Opcional
orden	String	Opcional
valor	String

5.2 Ejemplo

5.2.1 Request

curl -X PUT https://test.easyfact.pe/see/rest/01 \
  -u "demo:demo" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "items": [
        {
            "ordenItem": "1",
            "idProducto": "39",
            "adicionales": [],
            "cantidadItem": "1",
            "descuentoItem": "0.00",
            "importeIGVItem": "15.25",
            "montoTotalItem": "100.00",
            "valorVentaItem": "84.75",
            "descripcionItem": "GATORADE 0.650 ML 4",
            "unidadMedidaItem": "PK",
            "codigoProductoItem": "0005",
            "codigoDescuentoItem": "00",
            "valorUnitarioSinIgv": "84.7457627119",
            "precioUnitarioConIgv": "100.0000000000",
            "unidadMedidaComercial": "PAQ",
            "codigoAfectacionIGVItem": "10",
            "porcentajeDescuentoItem": "0.00",
            "codTipoPrecioVtaUnitarioItem": "01"
        },
        {
            "ordenItem": "2",
            "idProducto": "41",
            "adicionales": [
                {
                    "clave": null,
                    "orden": null,
                    "valor": "Adicional producto permanente 1",
                    "noImprimir": false
                },
                {
                    "clave": null,
                    "orden": null,
                    "valor": "Adicional producto permanente 2",
                    "noImprimir": false
                }
            ],
            "cantidadItem": "1",
            "descuentoItem": "0.00",
            "importeIGVItem": "15.25",
            "montoTotalItem": "100.00",
            "valorVentaItem": "84.75",
            "descripcionItem": "COCA - COLA 1LT",
            "unidadMedidaItem": "BX",
            "codigoProductoItem": "0001",
            "codigoDescuentoItem": "00",
            "valorUnitarioSinIgv": "84.7457627119",
            "precioUnitarioConIgv": "100.0000000000",
            "unidadMedidaComercial": "CJA",
            "codigoAfectacionIGVItem": "10",
            "porcentajeDescuentoItem": "0.00",
            "clasificacionProductoItem": "14101501",
            "codTipoPrecioVtaUnitarioItem": "01"
        },
        {
            "ordenItem": "3",
            "idProducto": "44",
            "adicionales": [
                {
                    "clave": null,
                    "orden": null,
                    "valor": "permanente de INCA KOLA",
                    "noImprimir": false
                }
            ],
            "cantidadItem": "1",
            "descuentoItem": "0.00",
            "importeIGVItem": "15.25",
            "montoTotalItem": "100.00",
            "valorVentaItem": "84.75",
            "descripcionItem": "INKA COLA 1.5 LT",
            "unidadMedidaItem": "BX",
            "codigoProductoItem": "0002",
            "codigoDescuentoItem": "00",
            "valorUnitarioSinIgv": "84.7457627119",
            "precioUnitarioConIgv": "100.0000000000",
            "unidadMedidaComercial": "CJA",
            "codigoAfectacionIGVItem": "10",
            "porcentajeDescuentoItem": "0.00",
            "codTipoPrecioVtaUnitarioItem": "01"
        }
    ],
    "server": {
        "serie": "F001",
        "numero": 8,
        "idEmpresa": 19,
        "idUsuario": 48,
        "noValidar": false,
        "idPuntoventa": 34,
        "condicionPago": "",
        "idListaPrecio": 0,
        "enviarAdjuntoDescomprimido": true
    },
    "anulado": false,
    "declare": "0",
    "version": "2.1",
    "adjuntos": [],
    "anticipos": [],
    "formaPago": "CONTADO",
    "ubigeoPOS": "010102",
    "esFicticio": false,
    "keepNumber": "false",
    "tipoCorreo": "2",
    "tipoMoneda": "PEN",
    "adicionales": [],
    "distritoPOS": "ASUNCI\u00d3N",
    "horaEmision": "00:53:45",
    "serieNumero": "F001-000008",
    "direccionPOS": "AV. GRAN CHIMU 456",
    "fechaEmision": "2026-07-31",
    "importeTotal": "300.00",
    "notification": "1",
    "provinciaPOS": "CHACHAPOYAS",
    "sumatoriaIGV": "45.76",
    "sumatoriaISC": "0.00",
    "ubigeoEmisor": "150136",
    "creditoCuotas": [],
    "tipoDocumento": "01",
    "distritoEmisor": "SAN MIGUEL",
    "esContingencia": false,
    "formaPagoGlosa": "CONTADO",
    "telefonoEmisor": "+51 997 724 338",
    "totalAnticipos": "0.00",
    "ubigeoReceptor": "150117",
    "departamentoPOS": "AMAZONAS",
    "direccionEmisor": "AV. DEL PACIFICO 180 SAN MIGUEL",
    "provinciaEmisor": "LIMA",
    "totalDescuentos": "0.00",
    "totalOPGravadas": "254.24",
    "codigoPaisEmisor": "PE",
    "distritoReceptor": "LOS OLIVOS",
    "totalOPGratuitas": "0.00",
    "direccionReceptor": "JR. JOSE SALAZAR NRO. 183 DPTO. 101 URB. PANAMERICANA NORTE",
    "docAfectadoFisico": false,
    "importeTotalVenta": "300.00",
    "provinciaReceptor": "LIMA",
    "razonSocialEmisor": "BYH CONSULTING S.A.C.",
    "totalOPExoneradas": "0.00",
    "totalOPNoGravadas": "0.00",
    "codigoPaisReceptor": "PE",
    "departamentoEmisor": "LIMA",
    "descuentosGlobales": "0.00",
    "nombreComercialPOS": "SUCURSAL",
    "urbanizacionEmisor": "",
    "codigoTipoOperacion": "0101",
    "razonSocialReceptor": "RAYANTUR S.A.",
    "departamentoReceptor": "LIMA",
    "sumatoriaOtrosCargos": "0",
    "codigoEstablecimiento": "0001",
    "nombreComercialEmisor": "EXCLUSIVIDAD EN JEANS",
    "tipoDocIdentidadEmisor": "6",
    "sumatoriaImpuestoBolsas": "0.00",
    "numeroDocIdentidadEmisor": "20601973759",
    "tipoDocIdentidadReceptor": "6",
    "numeroDocIdentidadReceptor": "20601073537"
}'

5.2.2 Response

{
    "result": "0",
    "body": {
        "single": {
            "id": 668436,
            "_number": 0,
            "result": "FIRMADO",
            "hash": "."
        }
    },
    "multiple": []
}

5.3 Consulta

5.3.1 Request

curl -X GET https://test.easyfact.pe/see/rest/01/6/20601973759/F001-000008 \
  -u "demo:demo" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"

5.3.2 Response

{
    "result": "0",
    "body": {
        "single": {
            "id": 668436,
            "tde": "6",
            "nde": "20601973759",
            "td": "01",
            "sn": "F001-000008",
            "_series": "F001",
            "_number": 8,
            "result": "FIRMADO",
            "message": "",
            "notes": "",
            "hash": "."
        }
    },
    "multiple": []
}

6. Boleta

6.1 Diccionario de datos

6.1.1 Cabecera

Atributo	Tipo	Comentario
1. Datos Generales
serieNumero	String	Ej. B001-000001
fechaEmision	String	Formato YYYY-MM-DD
tipoDocumento	String	03
tipoMoneda	String	PEN o USD
codigoTipoOperacion	String
serieNumeroGuia	String	Opcional
tipoDocumentoGuia	String	Opcional
2. Datos del Emisor
numeroDocIdentidadEmisor	String	DNI (8 dígitos) o RUC (11 dígitos)
tipoDocIdentidadEmisor	String	Siempre es 6
nombreComercialEmisor	String	Opcional
razonSocialEmisor	String	Opcional
ubigeoEmisor	String	Opcional
direccionEmisor	String	Opcional
urbanizacionEmisor	String	Opcional
departamentoEmisor	String	Opcional
provinciaEmisor	String	Opcional
distritoEmisor	String	Opcional
codigoPaisEmisor	String	Opcional
3. Datos del Receptor
numeroDocIdentidadReceptor	String	DNI (8 dígitos) o RUC (11 dígitos)
tipoDocIdentidadReceptor	String	Siempre es 6
razonSocialReceptor	String
4. Totales
importeTotal	String
totalOPGravadas	String
totalOPNoGravadas	String	Opcional
totalOPExoneradas	String	Opcional
totalDescuentos	String	Opcional
sumatoriaIGV	String
sumatoriaISC	String	Opcional
sumatoriaOtrosTributos	String	Opcional
descuentosGlobales	String	Opcional
sumatoriaOtrosCargos	String	Opcional
importeTotalVenta	String

6.1.2 Items

Atributo	Tipo	Comentario
ordenItem	String
unidadMedidaItem	String
cantidadItem	String
codigoProductoItem	String
descripcionItem	String
valorUnitarioSinIgv	String
precioUnitarioConIgv	String
codTipoPrecioVtaUnitarioItem	String
codigoAfectacionIGVItem	String
montoISCItem	String	Opcional
tipoSistemaISCItem	String	Opcional
montoReferenciaItem	String	Opcional
codigoTipoPrecioReferencial	String	Opcional
descuentoItem	String	Opcional
valorVentaItem	String

6.1.3 Adicionales

Atributo	Tipo	Comentario
clave	String	Opcional
orden	String	Opcional
valor	String

6.2 Ejemplo

6.2.1 Request

curl -X PUT https://test.easyfact.pe/see/rest/03 \
  -u "demo:demo" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "items": [
        {
            "ordenItem": "1",
            "idProducto": "41",
            "adicionales": [
                {
                    "clave": null,
                    "orden": null,
                    "valor": "Adicional producto permanente 1",
                    "noImprimir": false
                },
                {
                    "clave": null,
                    "orden": null,
                    "valor": "Adicional producto permanente 2",
                    "noImprimir": false
                }
            ],
            "cantidadItem": "1",
            "descuentoItem": "0.00",
            "importeIGVItem": "4.58",
            "montoTotalItem": "30.00",
            "valorVentaItem": "25.42",
            "descripcionItem": "COCA - COLA 1LT",
            "unidadMedidaItem": "NIU",
            "codigoProductoItem": "0001",
            "codigoDescuentoItem": "00",
            "valorUnitarioSinIgv": "25.4237288136",
            "precioUnitarioConIgv": "30.0000000000",
            "unidadMedidaComercial": "UND",
            "codigoAfectacionIGVItem": "10",
            "porcentajeDescuentoItem": "0.00",
            "clasificacionProductoItem": "14101501",
            "codTipoPrecioVtaUnitarioItem": "01"
        }
    ],
    "server": {
        "serie": "BP01",
        "numero": 2,
        "idEmpresa": 19,
        "idUsuario": 48,
        "noValidar": false,
        "idPuntoventa": 34,
        "condicionPago": "",
        "idListaPrecio": 0
    },
    "anulado": false,
    "version": "2.1",
    "adjuntos": [],
    "anticipos": [],
    "ubigeoPOS": "010102",
    "esFicticio": false,
    "keepNumber": "false",
    "tipoCorreo": "2",
    "tipoMoneda": "PEN",
    "adicionales": [],
    "distritoPOS": "ASUNCI\u00d3N",
    "horaEmision": "23:58:18",
    "serieNumero": "BP01-000002",
    "direccionPOS": "AV. GRAN CHIMU 456",
    "fechaEmision": "2026-08-01",
    "importeTotal": "30.00",
    "notification": "1",
    "provinciaPOS": "CHACHAPOYAS",
    "sumatoriaIGV": "4.58",
    "sumatoriaISC": "0.00",
    "ubigeoEmisor": "150136",
    "tipoDocumento": "03",
    "distritoEmisor": "SAN MIGUEL",
    "esContingencia": false,
    "telefonoEmisor": "+51 997 724 338",
    "totalAnticipos": "0.00",
    "departamentoPOS": "AMAZONAS",
    "direccionEmisor": "AV. DEL PACIFICO 180 SAN MIGUEL",
    "provinciaEmisor": "LIMA",
    "totalDescuentos": "0.00",
    "totalOPGravadas": "25.42",
    "codigoPaisEmisor": "PE",
    "totalOPGratuitas": "0.00",
    "direccionReceptor": "-",
    "docAfectadoFisico": false,
    "importeTotalVenta": "30.00",
    "razonSocialEmisor": "BYH CONSULTING S.A.C.",
    "totalOPExoneradas": "0.00",
    "totalOPNoGravadas": "0.00",
    "departamentoEmisor": "LIMA",
    "descuentosGlobales": "0.00",
    "nombreComercialPOS": "SUCURSAL",
    "urbanizacionEmisor": "",
    "codigoTipoOperacion": "0101",
    "razonSocialReceptor": "PUBLICO GENERAL",
    "sumatoriaOtrosCargos": "0",
    "codigoEstablecimiento": "0001",
    "nombreComercialEmisor": "EXCLUSIVIDAD EN JEANS",
    "tipoDocIdentidadEmisor": "6",
    "sumatoriaImpuestoBolsas": "0.00",
    "numeroDocIdentidadEmisor": "20601973759",
    "tipoDocIdentidadReceptor": "0",
    "numeroDocIdentidadReceptor": "00000000"
}'

6.2.2 Response

{
    "result": "0",
    "body": {
        "single": {
            "id": 668440,
            "_number": 0,
            "result": "FIRMADO",
            "hash": "."
        }
    },
    "multiple": []
}

6.3 Consulta

6.3.1 Request

curl -X GET https://test.easyfact.pe/see/rest/03/6/20601973759/BP01-000002 \
  -u "demo:demo" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"

6.3.2 Response

{
    "result": "0",
    "body": {
        "single": {
            "id": 668440,
            "tde": "6",
            "nde": "20601973759",
            "td": "03",
            "sn": "BP01-000002",
            "_series": "BP01",
            "_number": 2,
            "result": "FIRMADO",
            "message": "",
            "notes": "",
            "hash": "."
        }
    },
    "multiple": []
}

7. Nota de crédito

7.1 Diccionario de datos

7.1.1 Cabecera

Atributo	Tipo	Comentario
1. Datos Generales
serieNumero	String	Ej. FC01-000001
fechaEmision	String	Formato YYYY-MM-DD
tipoDocumento	String	07
tipoMoneda	String	PEN o USD
codigoTipoOperacion	String
serieNumeroGuia	String	Opcional
tipoDocumentoGuia	String	Opcional
tipoNotaCredito	String	Ej. 01
motivoSustento	String	Ej. ANULACIÓN DE LA OPERACIÓN
serieNumeroAfectado	String	Ej. F001-2
serieNumeroModifica	String	Ej. F001-2\|F001-3
tipoDocumentoModifica	String	Ej. 01
fechaDocumentoAfectado	String	Ej. 2026-07-21
2. Datos del Emisor
numeroDocIdentidadEmisor	String	DNI (8 dígitos) o RUC (11 dígitos)
tipoDocIdentidadEmisor	String	Siempre es 6
nombreComercialEmisor	String	Opcional
razonSocialEmisor	String	Opcional
ubigeoEmisor	String	Opcional
direccionEmisor	String	Opcional
urbanizacionEmisor	String	Opcional
departamentoEmisor	String	Opcional
provinciaEmisor	String	Opcional
distritoEmisor	String	Opcional
codigoPaisEmisor	String	Opcional
3. Datos del Receptor
numeroDocIdentidadReceptor	String	DNI (8 dígitos) o RUC (11 dígitos)
tipoDocIdentidadReceptor	String	Siempre es 6
razonSocialReceptor	String
4. Totales
importeTotal	String
totalOPGravadas	String
totalOPNoGravadas	String	Opcional
totalOPExoneradas	String	Opcional
totalDescuentos	String	Opcional
sumatoriaIGV	String
sumatoriaISC	String	Opcional
sumatoriaOtrosTributos	String	Opcional
descuentosGlobales	String	Opcional
sumatoriaOtrosCargos	String	Opcional
importeTotalVenta	String

7.1.2 Items

Atributo	Tipo	Comentario
ordenItem	String
unidadMedidaItem	String
cantidadItem	String
codigoProductoItem	String
descripcionItem	String
valorUnitarioSinIgv	String
precioUnitarioConIgv	String
codTipoPrecioVtaUnitarioItem	String
codigoAfectacionIGVItem	String
montoISCItem	String	Opcional
tipoSistemaISCItem	String	Opcional
montoReferenciaItem	String	Opcional
codigoTipoPrecioReferencial	String	Opcional
descuentoItem	String	Opcional
valorVentaItem	String

7.1.3 Adicionales

Atributo	Tipo	Comentario
clave	String	Opcional
orden	String	Opcional
valor	String

7.2 Ejemplo

7.2.1 Request


curl -X PUT https://test.easyfact.pe/see/rest/07 \  -u "demo:demo" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "items": [
        {
            "ordenItem": "1",
            "idProducto": "39",
            "adicionales": [],
            "cantidadItem": "1",
            "importeIGVItem": "15.25",
            "montoTotalItem": "100.00",
            "valorVentaItem": "84.75",
            "descripcionItem": "GATORADE 0.650 ML 4",
            "unidadMedidaItem": "PK",
            "codigoProductoItem": "0005",
            "valorUnitarioSinIgv": "84.7457627119",
            "precioUnitarioConIgv": "100.0000000000",
            "unidadMedidaComercial": "PAQ",
            "codigoAfectacionIGVItem": "10",
            "codTipoPrecioVtaUnitarioItem": "01"
        },
        {
            "ordenItem": "2",
            "idProducto": "41",
            "adicionales": [
                {
                    "clave": null,
                    "orden": null,
                    "valor": "Adicional producto permanente 1",
                    "noImprimir": false
                },
                {
                    "clave": null,
                    "orden": null,
                    "valor": "Adicional producto permanente 2",
                    "noImprimir": false
                }
            ],
            "cantidadItem": "1",
            "importeIGVItem": "15.25",
            "montoTotalItem": "100.00",
            "valorVentaItem": "84.75",
            "descripcionItem": "COCA - COLA 1LT",
            "unidadMedidaItem": "BX",
            "codigoProductoItem": "0001",
            "valorUnitarioSinIgv": "84.7457627119",
            "precioUnitarioConIgv": "100.0000000000",
            "unidadMedidaComercial": "CJA",
            "codigoAfectacionIGVItem": "10",
            "clasificacionProductoItem": "14101501",
            "codTipoPrecioVtaUnitarioItem": "01"
        },
        {
            "ordenItem": "3",
            "idProducto": "44",
            "adicionales": [
                {
                    "clave": null,
                    "orden": null,
                    "valor": "permanente de INCA KOLA",
                    "noImprimir": false
                }
            ],
            "cantidadItem": "1",
            "importeIGVItem": "15.25",
            "montoTotalItem": "100.00",
            "valorVentaItem": "84.75",
            "descripcionItem": "INKA COLA 1.5 LT",
            "unidadMedidaItem": "BX",
            "codigoProductoItem": "0002",
            "valorUnitarioSinIgv": "84.7457627119",
            "precioUnitarioConIgv": "100.0000000000",
            "unidadMedidaComercial": "CJA",
            "codigoAfectacionIGVItem": "10",
            "codTipoPrecioVtaUnitarioItem": "01"
        }
    ],
    "server": {
        "serie": "F002",
        "numero": 2,
        "idEmpresa": 19,
        "idUsuario": 48,
        "noValidar": false,
        "idPuntoventa": 34,
        "idListaPrecio": 0,
        "enviarAdjuntoDescomprimido": true
    },
    "anulado": false,
    "version": "2.1",
    "adjuntos": [],
    "ubigeoPOS": "010102",
    "esFicticio": false,
    "keepNumber": "false",
    "tipoCorreo": "2",
    "tipoMoneda": "PEN",
    "adicionales": [],
    "distritoPOS": "ASUNCI\u00d3N",
    "horaEmision": "01:00:29",
    "serieNumero": "F002-000002",
    "direccionPOS": "AV. GRAN CHIMU 456",
    "fechaEmision": "2026-07-21",
    "importeTotal": "300.00",
    "notification": "1",
    "provinciaPOS": "CHACHAPOYAS",
    "sumatoriaIGV": "45.76",
    "sumatoriaISC": "0.00",
    "ubigeoEmisor": "150136",
    "creditoCuotas": [],
    "tipoDocumento": "07",
    "distritoEmisor": "SAN MIGUEL",
    "esContingencia": false,
    "motivoSustento": "ANULACI\u00d3N DE LA OPERACI\u00d3N",
    "telefonoEmisor": "+51 997 724 338",
    "totalAnticipos": "0",
    "ubigeoReceptor": "150117",
    "departamentoPOS": "AMAZONAS",
    "direccionEmisor": "AV. DEL PACIFICO 180 SAN MIGUEL",
    "provinciaEmisor": "LIMA",
    "tipoNotaCredito": "01",
    "totalDescuentos": "0.00",
    "totalOPGravadas": "254.24",
    "codigoPaisEmisor": "PE",
    "distritoReceptor": "LOS OLIVOS",
    "totalOPGratuitas": "0.00",
    "direccionReceptor": "JR. JOSE SALAZAR NRO. 183 DPTO. 101 URB. PANAMERICANA NORTE",
    "docAfectadoFisico": true,
    "provinciaReceptor": "LIMA",
    "razonSocialEmisor": "BYH CONSULTING S.A.C.",
    "totalOPExoneradas": "0.00",
    "totalOPNoGravadas": "0.00",
    "codigoPaisReceptor": "PE",
    "departamentoEmisor": "LIMA",
    "nombreComercialPOS": "SUCURSAL",
    "urbanizacionEmisor": "",
    "razonSocialReceptor": "RAYANTUR S.A.",
    "serieNumeroAfectado": "F001-2",
    "serieNumeroModifica": "F001-2|F001-3",
    "departamentoReceptor": "LIMA",
    "sumatoriaOtrosCargos": "0",
    "codigoEstablecimiento": "0001",
    "nombreComercialEmisor": "EXCLUSIVIDAD EN JEANS",
    "tipoDocumentoModifica": "01",
    "fechaDocumentoAfectado": "2026-07-21",
    "tipoDocIdentidadEmisor": "6",
    "sumatoriaImpuestoBolsas": "0.00",
    "numeroDocIdentidadEmisor": "20601973759",
    "tipoDocIdentidadReceptor": "6",
    "numeroDocIdentidadReceptor": "20601073537"
}'

7.2.2 Response

{
    "result": "0",
    "body": {
        "single": {
            "id": 668440,
            "_number": 0,
            "result": "FIRMADO",
            "hash": "."
        }
    },
    "multiple": []
}

7.3 Consulta

7.3.1 Request

curl -X GET https://test.easyfact.pe/see/rest/07/6/20601973759/F002-000002 \
  -u "demo:demo" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"

7.3.2 Response

{
    "result": "0",
    "body": {
        "single": {
            "id": 630159,
            "tde": "6",
            "nde": "20601973759",
            "td": "07",
            "sn": "F002-000002",
            "_series": "F002",
            "_number": 2,
            "result": "ACEPTADO",
            "message": "La Nota de Credito numero F002-000002, ha sido aceptada",
            "notes": "",
            "send": "2026-07-21T01:00:29 00:00:00",
            "receive": "2026-07-21 02:07:47",
            "hash": "."
        }
    },
    "multiple": []
}

8. Nota de débito

8.1 Diccionario de datos

8.1.1 Cabecera

Atributo	Tipo	Comentario
1. Datos Generales
serieNumero	String	Ej. FD01-000001
fechaEmision	String	Formato YYYY-MM-DD
tipoDocumento	String	08
tipoMoneda	String	PEN o USD
codigoTipoOperacion	String
serieNumeroGuia	String	Opcional
tipoDocumentoGuia	String	Opcional
tipoNotaDebito	String	Ej. 01
motivoSustento	String	Ej. INTERESES POR MORA
serieNumeroAfectado	String	Ej. F001-2
serieNumeroModifica	String	Ej. F001-2\|F001-3
tipoDocumentoModifica	String	Ej. 01
fechaDocumentoAfectado	String	Ej. 2026-07-21
2. Datos del Emisor
numeroDocIdentidadEmisor	String	DNI (8 dígitos) o RUC (11 dígitos)
tipoDocIdentidadEmisor	String	Siempre es 6
nombreComercialEmisor	String	Opcional
razonSocialEmisor	String	Opcional
ubigeoEmisor	String	Opcional
direccionEmisor	String	Opcional
urbanizacionEmisor	String	Opcional
departamentoEmisor	String	Opcional
provinciaEmisor	String	Opcional
distritoEmisor	String	Opcional
codigoPaisEmisor	String	Opcional
3. Datos del Receptor
numeroDocIdentidadReceptor	String	DNI (8 dígitos) o RUC (11 dígitos)
tipoDocIdentidadReceptor	String	Siempre es 6
razonSocialReceptor	String
4. Totales
importeTotal	String
totalOPGravadas	String
totalOPNoGravadas	String	Opcional
totalOPExoneradas	String	Opcional
totalDescuentos	String	Opcional
sumatoriaIGV	String
sumatoriaISC	String	Opcional
sumatoriaOtrosTributos	String	Opcional
descuentosGlobales	String	Opcional
sumatoriaOtrosCargos	String	Opcional
importeTotalVenta	String

8.1.2 Items

Atributo	Tipo	Comentario
ordenItem	String
unidadMedidaItem	String
cantidadItem	String
codigoProductoItem	String
descripcionItem	String
valorUnitarioSinIgv	String
precioUnitarioConIgv	String
codTipoPrecioVtaUnitarioItem	String
codigoAfectacionIGVItem	String
montoISCItem	String	Opcional
tipoSistemaISCItem	String	Opcional
montoReferenciaItem	String	Opcional
codigoTipoPrecioReferencial	String	Opcional
descuentoItem	String	Opcional
valorVentaItem	String

8.1.3 Adicionales

Atributo	Tipo	Comentario
clave	String	Opcional
orden	String	Opcional
valor	String

8.2 Ejemplo

8.2.1 Request


curl -X PUT https://test.easyfact.pe/see/rest/08 \  -u "demo:demo" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "items": [
        {
            "ordenItem": "1",
            "idProducto": "39",
            "adicionales": [],
            "cantidadItem": "1",
            "importeIGVItem": "15.25",
            "montoTotalItem": "100.00",
            "valorVentaItem": "84.75",
            "descripcionItem": "GATORADE 0.650 ML 4",
            "unidadMedidaItem": "PK",
            "codigoProductoItem": "0005",
            "valorUnitarioSinIgv": "84.7457627119",
            "precioUnitarioConIgv": "100.0000000000",
            "unidadMedidaComercial": "PAQ",
            "codigoAfectacionIGVItem": "10",
            "codTipoPrecioVtaUnitarioItem": "01"
        },
        {
            "ordenItem": "2",
            "idProducto": "41",
            "adicionales": [
                {
                    "clave": null,
                    "orden": null,
                    "valor": "Adicional producto permanente 1",
                    "noImprimir": false
                },
                {
                    "clave": null,
                    "orden": null,
                    "valor": "Adicional producto permanente 2",
                    "noImprimir": false
                }
            ],
            "cantidadItem": "1",
            "importeIGVItem": "15.25",
            "montoTotalItem": "100.00",
            "valorVentaItem": "84.75",
            "descripcionItem": "COCA - COLA 1LT",
            "unidadMedidaItem": "BX",
            "codigoProductoItem": "0001",
            "valorUnitarioSinIgv": "84.7457627119",
            "precioUnitarioConIgv": "100.0000000000",
            "unidadMedidaComercial": "CJA",
            "codigoAfectacionIGVItem": "10",
            "clasificacionProductoItem": "14101501",
            "codTipoPrecioVtaUnitarioItem": "01"
        },
        {
            "ordenItem": "3",
            "idProducto": "44",
            "adicionales": [
                {
                    "clave": null,
                    "orden": null,
                    "valor": "permanente de INCA KOLA",
                    "noImprimir": false
                }
            ],
            "cantidadItem": "1",
            "importeIGVItem": "15.25",
            "montoTotalItem": "100.00",
            "valorVentaItem": "84.75",
            "descripcionItem": "INKA COLA 1.5 LT",
            "unidadMedidaItem": "BX",
            "codigoProductoItem": "0002",
            "valorUnitarioSinIgv": "84.7457627119",
            "precioUnitarioConIgv": "100.0000000000",
            "unidadMedidaComercial": "CJA",
            "codigoAfectacionIGVItem": "10",
            "codTipoPrecioVtaUnitarioItem": "01"
        }
    ],
    "server": {
        "serie": "FD01",
        "numero": 1,
        "idEmpresa": 19,
        "idUsuario": 48,
        "noValidar": false,
        "idPuntoventa": 34,
        "idListaPrecio": 0,
        "enviarAdjuntoDescomprimido": true
    },
    "anulado": false,
    "version": "2.1",
    "adjuntos": [],
    "ubigeoPOS": "010102",
    "esFicticio": false,
    "keepNumber": "false",
    "tipoCorreo": "2",
    "tipoMoneda": "PEN",
    "adicionales": [],
    "distritoPOS": "ASUNCI\u00d3N",
    "horaEmision": "01:00:29",
    "serieNumero": "FD01-000001",
    "direccionPOS": "AV. GRAN CHIMU 456",
    "fechaEmision": "2026-07-21",
    "importeTotal": "300.00",
    "notification": "1",
    "provinciaPOS": "CHACHAPOYAS",
    "sumatoriaIGV": "45.76",
    "sumatoriaISC": "0.00",
    "ubigeoEmisor": "150136",
    "creditoCuotas": [],
    "tipoDocumento": "08",
    "distritoEmisor": "SAN MIGUEL",
    "esContingencia": false,
    "motivoSustento": "ANULACI\u00d3N DE LA OPERACI\u00d3N",
    "telefonoEmisor": "+51 997 724 338",
    "totalAnticipos": "0",
    "ubigeoReceptor": "150117",
    "departamentoPOS": "AMAZONAS",
    "direccionEmisor": "AV. DEL PACIFICO 180 SAN MIGUEL",
    "provinciaEmisor": "LIMA",
    "totalDescuentos": "0.00",
    "totalOPGravadas": "254.24",
    "codigoPaisEmisor": "PE",
    "distritoReceptor": "LOS OLIVOS",
    "totalOPGratuitas": "0.00",
    "direccionReceptor": "JR. JOSE SALAZAR NRO. 183 DPTO. 101 URB. PANAMERICANA NORTE",
    "docAfectadoFisico": true,
    "provinciaReceptor": "LIMA",
    "razonSocialEmisor": "BYH CONSULTING S.A.C.",
    "totalOPExoneradas": "0.00",
    "totalOPNoGravadas": "0.00",
    "codigoPaisReceptor": "PE",
    "departamentoEmisor": "LIMA",
    "nombreComercialPOS": "SUCURSAL",
    "urbanizacionEmisor": "",
    "razonSocialReceptor": "RAYANTUR S.A.",
    "serieNumeroAfectado": "F001-2",
    "serieNumeroModifica": "F001-2|F001-3",
    "departamentoReceptor": "LIMA",
    "sumatoriaOtrosCargos": "0",
    "codigoEstablecimiento": "0001",
    "nombreComercialEmisor": "EXCLUSIVIDAD EN JEANS",
    "tipoDocumentoModifica": "01",
    "fechaDocumentoAfectado": "2026-07-21",
    "tipoDocIdentidadEmisor": "6",
    "sumatoriaImpuestoBolsas": "0.00",
    "numeroDocIdentidadEmisor": "20601973759",
    "tipoDocIdentidadReceptor": "6",
    "numeroDocIdentidadReceptor": "20601073537",
    "tipoNotaDebito": "01"
}'

8.2.2 Response

{
    "result": "0",
    "body": {
        "single": {
            "id": 668440,
            "_number": 0,
            "result": "FIRMADO",
            "hash": "."
        }
    },
    "multiple": []
}

8.3 Consulta

8.3.1 Request

curl -X GET https://test.easyfact.pe/see/rest/08/6/20601973759/FD01-000001 \
  -u "demo:demo" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"

8.3.2 Response

{
    "result": "0",
    "body": {
        "single": {
            "id": 630160,
            "tde": "6",
            "nde": "20601973759",
            "td": "08",
            "sn": "FD01-000001",
            "_series": "FD01",
            "_number": 1,
            "result": "ACEPTADO",
            "message": "La Nota de Debito numero FD01-000001, ha sido aceptada",
            "notes": "",
            "send": "2026-07-21T01:00:29 00:00:00",
            "receive": "2026-07-21 02:07:47",
            "hash": "."
        }
    },
    "multiple": []
}

Documentación API REST - Facturación Electrónica