Add new XML test cases for DespatchAdvice and update summary documents

- Created multiple XML test cases for DespatchAdvice under GRETransportistaCasuisticasTest, including:
  - vehiculoM1L.xml
  - transportistaBasico.xml
  - transportistaComercioExterior.xml
  - transportistaConCarreta.xml
  - transportistaMultiplesConductores.xml
- Updated summaryDocuments.xml and summaryDocuments_anularBoletaExonerada.xml to include TaxPercent elements for tax subtotals.

Signed-off-by: Edwin Luis Barboza Pinedo <ibarboza27498@gmail.com>

Author: muglerman

examples/springbot/src/main/java/io/github/project/openubl/quickstart/xbuilder/springboot/XBuilderController.java

@@ -1,22 +1,104 @@
+/*
+ * Catálogo 20 - Motivo de traslado
+ *
+ * Fuente normativa: Anexo N.° 8 de la RS 000123-2022/SUNAT,
+ *                   actualizado por RS 000240-2024/SUNAT.
+ */
 package io.github.project.openubl.xbuilder.content.catalogs;
 
+import java.util.Optional;
+import java.util.stream.Stream;
+
+/**
+ * Catálogo N.° 20 - Motivo de traslado.
+ * <p>
+ * Vigente según RS 000123-2022/SUNAT y RS 000240-2024/SUNAT.
+ * Aplicable tanto a GRE-Remitente (09) como GRE-Transportista (31).
+ */
 public enum Catalog20 implements Catalog {
+
+    /** 01 - Venta */
     VENTA("01"),
-    VENTA_SUJETA_A_CONFIRMACION_DEL_COMPRADOR("14"),
+
+    /** 02 - Compra */
     COMPRA("02"),
-    TRASLADO_ENTRE_ESTABLECIMIENTOS_DE_LA_MISMA_EMPRESA("04"),
-    TRASLADO_EMISOR_ITINERANTE_CP("18"),
+
+    /** 03 - Venta con entrega a terceros (consignación) */
+    CONSIGNACION("03"),
+
+    /** 04 - Traslado entre establecimientos de la misma empresa */
+    TRASLADO_ENTRE_ESTABLECIMIENTOS("04"),
+
+    /** 05 - Devolución */
+    DEVOLUCION("05"),
+
+    /** 06 - Traslado de bienes para transformación */
+    TRASLADO_TRANSFORMACION("06"),
+
+    /** 07 - Recojo de bienes transformados */
+    RECOJO_BIENES_TRANSFORMADOS("07"),
+
+    /** 08 - Importación */
     IMPORTACION("08"),
+
+    /** 09 - Exportación */
     EXPORTACION("09"),
-    TRASLADO_A_ZONA_PRIMARIA("19"),
-    OTROS("13");
+
+    /**
+     * 10 - Importación: traslado de bienes con DAM/DS con levante.
+     * <p>
+     * Aplica cuando la mercancía tiene levante autorizado.
+     * Incorporado por RS 000240-2024/SUNAT para trazabilidad de comercio exterior.
+     * Vigente desde 14-nov-2024; uso como motivo mandatorio pospuesto al
+     * 01-jul-2026.
+     */
+    IMPORTACION_CON_DAM("10"),
+
+    /** 11 - Importación temporal */
+    IMPORTACION_TEMPORAL("11"),
+
+    /** 13 - Otros */
+    OTROS("13"),
+
+    /** 14 - Venta sujeta a confirmación del comprador */
+    VENTA_SUJETA_A_CONFIRMACION("14"),
+
+    /**
+     * 15 - Traslado de bienes zona IVAP.
+     * <p>
+     * Aplica para traslados de bienes gravados con IVAP (arroz).
+     */
+    TRASLADO_ZONA_IVAP("15"),
+
+    /** 16 - Exportación temporal (admisión temporal) */
+    EXPORTACION_TEMPORAL("16"),
+
+    /** 17 - Reexportación */
+    REEXPORTACION("17"),
+
+    /** 18 - Traslado emisor itinerante de comprobantes de pago */
+    TRASLADO_EMISOR_ITINERANTE_CP("18"),
+
+    /**
+     * 19 - Traslado de mercancía extranjera (zona primaria a depósito temporal).
+     * <p>
+     * Uso obligatorio a partir del 01-jul-2026 para traslado de mercancía
+     * extranjera sin destinación aduanera o sin levante, en reemplazo del ticket de
+     * salida.
+     * Vigencia de la derogación del ticket pospuesta por RS 000133-2025/SUNAT.
+     */
+    TRASLADO_MERCANCIA_EXTRANJERA("19");
 
     private final String code;
 
     Catalog20(String code) {
         this.code = code;
     }
 
+    public static Optional<Catalog20> valueOfCode(String code) {
+        return Stream.of(Catalog20.values()).filter(p -> p.code.equals(code)).findFirst();
+    }
+
     @Override
     public String getCode() {
         return code;

xbuilder/core/src/main/java/io/github/project/openubl/xbuilder/content/catalogs/Catalog20.java

@@ -1,19 +1,64 @@
 package io.github.project.openubl.xbuilder.content.catalogs;
 
+import java.util.Optional;
+import java.util.stream.Stream;
+
+/**
+ * Catálogo N.° 21 - Tipo de documento relacionado a la Guía de Remisión
+ * Electrónica.
+ * <p>
+ * Fuente: Anexo N.° 8 de la RS 000123-2022/SUNAT.
+ * Se utiliza en {@code cac:AdditionalDocumentReference / cbc:DocumentTypeCode}.
+ */
 public enum Catalog21 implements Catalog {
+    /** 01 - Numeración DAM (Declaración Aduanera de Mercancías) */
     NUMERACION_DAM("01"),
+
+    /** 02 - Número de orden de entrega */
     NUMERO_DE_ORDEN_DE_ENTREGA("02"),
+
+    /** 03 - Número SCOP */
     NUMERO_SCOP("03"),
+
+    /** 04 - Número de manifiesto de carga */
     NUMERO_DE_MANIFIESTO_DE_CARGA("04"),
+
+    /** 05 - Número de constancia de detracción */
     NUMERO_DE_CONSTANCIA_DE_DETRACCION("05"),
-    OTROS("06");
+
+    /** 06 - Otros */
+    OTROS("06"),
+
+    /** 09 - Guía de remisión remitente */
+    GUIA_REMISION_REMITENTE("09"),
+
+    /** 12 - Declaración Simplificada (DS) */
+    DECLARACION_SIMPLIFICADA("12"),
+
+    /** 31 - Guía de remisión transportista */
+    GUIA_REMISION_TRANSPORTISTA("31"),
+
+    /**
+     * 49 - Ticket de salida ENAPU.
+     * <p>
+     * Vigente condicionalmente: la derogación del ticket de salida ha sido
+     * pospuesta al 01-jul-2026 por RS 000133-2025/SUNAT.
+     */
+    TICKET_SALIDA("49"),
+
+    /** 50 - Código de autorización emitido por SUNAT */
+    CODIGO_AUTORIZACION_SUNAT("50");
 
     private final String code;
 
     Catalog21(String code) {
         this.code = code;
     }
 
+    public static Optional<Catalog21> valueOfCode(String code) {
+        return Stream.of(Catalog21.values()).filter(p -> p.code.equals(code)).findFirst();
+    }
+
     @Override
     public String getCode() {
         return code;

xbuilder/core/src/main/java/io/github/project/openubl/xbuilder/content/catalogs/Catalog21.java

@@ -0,0 +1,68 @@
+/*
+ * Catálogo 61 - Tipo de documento adicional relacionado al transporte
+ *
+ * Fuente normativa: Anexo N.° 8, Catálogo N.° 61 de la RS 000123-2022/SUNAT.
+ * Estos documentos se consignan en cac:AdditionalDocumentReference de la GRE
+ * con un DocumentTypeCode basado en este catálogo.
+ */
+package io.github.project.openubl.xbuilder.content.catalogs;
+
+import java.util.Optional;
+import java.util.stream.Stream;
+
+/**
+ * Catálogo N.° 61 - Tipo de documento adicional relacionado al transporte.
+ * <p>
+ * Aplicable a los campos {@code cac:AdditionalDocumentReference} de la GRE
+ * correspondientes a documentos del ámbito de transporte y comercio exterior.
+ */
+public enum Catalog61 implements Catalog {
+
+    /** 01 - Factura */
+    FACTURA("01"),
+
+    /** 02 - Boleta de venta */
+    BOLETA_VENTA("02"),
+
+    /** 03 - Liquidación de compra */
+    LIQUIDACION_COMPRA("03"),
+
+    /** 04 - Guía de remisión remitente */
+    GUIA_REMISION_REMITENTE("04"),
+
+    /** 05 - Guía de remisión transportista */
+    GUIA_REMISION_TRANSPORTISTA("05"),
+
+    /** 06 - Carta de porte aéreo */
+    CARTA_PORTE_AEREO("06"),
+
+    /** 07 - Póliza de adjudicación */
+    POLIZA_ADJUDICACION("07"),
+
+    /** 09 - Guía de remisión remitente complementaria */
+    GUIA_REMISION_REMITENTE_COMP("09"),
+
+    /** 10 - Guía de remisión transportista complementaria */
+    GUIA_REMISION_TRANSPORTISTA_COMP("10"),
+
+    /** 50 - DAM (Declaración Aduanera de Mercancías) */
+    DAM("50"),
+
+    /** 52 - Declaración Simplificada de Importación/Exportación */
+    DECLARACION_SIMPLIFICADA("52");
+
+    private final String code;
+
+    Catalog61(String code) {
+        this.code = code;
+    }
+
+    public static Optional<Catalog61> valueOfCode(String code) {
+        return Stream.of(Catalog61.values()).filter(p -> p.code.equals(code)).findFirst();
+    }
+
+    @Override
+    public String getCode() {
+        return code;
+    }
+}

xbuilder/core/src/main/java/io/github/project/openubl/xbuilder/content/catalogs/Catalog61.java

@@ -0,0 +1,50 @@
+/*
+ * Catálogo 62 - Bienes normalizados sujetos a SPOT/IVAP
+ *
+ * Fuente normativa: Anexo N.° 8, Catálogo N.° 62 de la RS 000123-2022/SUNAT.
+ *
+ * Nota SUNAT FAQ #25: Se consideran bienes normalizados los bienes detallados
+ * en este catálogo CUANDO se encuentran sujetos al SPOT o IVAP. Si no están
+ * sujetos, no califican como bien normalizado y no se marca el indicador.
+ */
+package io.github.project.openubl.xbuilder.content.catalogs;
+
+import java.util.Optional;
+import java.util.stream.Stream;
+
+/**
+ * Catálogo N.° 62 - Bienes normalizados sujetos a detracción (SPOT) o IVAP.
+ * <p>
+ * Se utiliza para marcar el indicador SUNAT_Envio_IndicadorBienNormalizado
+ * en el XML de la GRE cuando se transportan estos bienes y están sujetos
+ * a SPOT/IVAP.
+ */
+public enum Catalog62 implements Catalog {
+
+    /** Azúcar - sujeto a SPOT */
+    AZUCAR("01"),
+
+    /** Arroz - sujeto a IVAP */
+    ARROZ("02"),
+
+    /** Alcohol etílico - sujeto a SPOT */
+    ALCOHOL_ETILICO("03"),
+
+    /** Cemento (zonas de control de IQBF) */
+    CEMENTO("04");
+
+    private final String code;
+
+    Catalog62(String code) {
+        this.code = code;
+    }
+
+    public static Optional<Catalog62> valueOfCode(String code) {
+        return Stream.of(Catalog62.values()).filter(p -> p.code.equals(code)).findFirst();
+    }
+
+    @Override
+    public String getCode() {
+        return code;
+    }
+}

xbuilder/core/src/main/java/io/github/project/openubl/xbuilder/content/catalogs/Catalog62.java

@@ -0,0 +1,60 @@
+/*
+ * Catálogo 63 - Puertos
+ *
+ * Fuente normativa: Anexo N.° 8, Catálogo N.° 63 de la RS 000123-2022/SUNAT.
+ * Se utiliza como código de ubicación en FirstArrivalPortLocation con LocationTypeCode=1.
+ *
+ * Nota: Los puertos mencionados explícitamente en el RCP art. 21 numeral 3.2.9
+ * son Callao, Paita, Salaverry, Chimbote, Pisco, Ilo, Matarani y Chancay
+ * (este último agregado por RS 000240-2024/SUNAT).
+ */
+package io.github.project.openubl.xbuilder.content.catalogs;
+
+import java.util.Optional;
+import java.util.stream.Stream;
+
+/**
+ * Catálogo N.° 63 - Puertos nacionales.
+ * <p>
+ * Utilizado en {@code cac:FirstArrivalPortLocation / cbc:ID} con
+ * {@code cbc:LocationTypeCode = 1} para indicar puerto de embarque/desembarque.
+ */
+public enum Catalog63 implements Catalog {
+
+    CALLAO("CALLAO", "Puerto del Callao"),
+    PAITA("PAITA", "Puerto de Paita"),
+    SALAVERRY("SALAVERRY", "Puerto de Salaverry"),
+    CHIMBOTE("CHIMBOTE", "Puerto de Chimbote"),
+    PISCO("PISCO", "Puerto de Pisco"),
+    ILO("ILO", "Puerto de Ilo"),
+    MATARANI("MATARANI", "Puerto de Matarani"),
+
+    /**
+     * Puerto de Chancay - agregado por RS 000240-2024/SUNAT para comercio exterior.
+     * Vigente desde 14-nov-2024.
+     */
+    CHANCAY("CHANCAY", "Puerto de Chancay");
+
+    private final String code;
+    private final String description;
+
+    Catalog63(String code, String description) {
+        this.code = code;
+        this.description = description;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public static Optional<Catalog63> valueOfCode(String code) {
+        return Stream.of(Catalog63.values())
+                .filter(p -> p.code.equalsIgnoreCase(code))
+                .findFirst();
+    }
+
+    @Override
+    public String getCode() {
+        return code;
+    }
+}