chore(nominaCatalogs): add new methods for nomina catalogs

Author: raul-facturapi

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.3.0] - 2026-10-07
+
+### Added
+
+- Add `nominaCatalogs().searchDeductions` and `nominaCatalogs().searchPerceptions` to search the SAT payroll deduction and perception catalogs.
+
 ## [2.2.0] - 2026-09-09
 
 ### Added

README.es.md

@@ -62,6 +62,13 @@ var invoice = facturapi.invoices().create(Map.of(
 System.out.println(invoice.getId());
 ```
 
+## Catálogos de nómina
+
+```java
+var deductions = facturapi.nominaCatalogs().searchDeductions(Map.of("q", "001"));
+var perceptions = facturapi.nominaCatalogs().searchPerceptions(Map.of("q", "001"));
+```
+
 ## Subidas
 
 ```java

README.md

@@ -62,6 +62,13 @@ var invoice = facturapi.invoices().create(Map.of(
 System.out.println(invoice.getId());
 ```
 
+## Payroll catalogs
+
+```java
+var deductions = facturapi.nominaCatalogs().searchDeductions(Map.of("q", "001"));
+var perceptions = facturapi.nominaCatalogs().searchPerceptions(Map.of("q", "001"));
+```
+
 ## Uploads
 
 ```java

src/main/java/io/facturapi/Facturapi.java

@@ -17,6 +17,7 @@
 import io.facturapi.tools.CartaPorteCatalogsTool;
 import io.facturapi.tools.CatalogsTool;
 import io.facturapi.tools.ComercioExteriorCatalogsTool;
+import io.facturapi.tools.NominaCatalogsTool;
 import io.facturapi.tools.ToolsResource;
 import java.time.Duration;
 
@@ -34,6 +35,7 @@ public class Facturapi {
   private final CatalogsTool catalogs;
   private final CartaPorteCatalogsTool cartaPorteCatalogs;
   private final ComercioExteriorCatalogsTool comercioExteriorCatalogs;
+  private final NominaCatalogsTool nominaCatalogs;
   private final ToolsResource tools;
 
   /**
@@ -73,6 +75,7 @@ public Facturapi(FacturapiConfig config) {
     this.catalogs = new CatalogsTool(httpClient);
     this.cartaPorteCatalogs = new CartaPorteCatalogsTool(httpClient);
     this.comercioExteriorCatalogs = new ComercioExteriorCatalogsTool(httpClient);
+    this.nominaCatalogs = new NominaCatalogsTool(httpClient);
     this.tools = new ToolsResource(httpClient);
   }
 
@@ -126,6 +129,10 @@ public ComercioExteriorCatalogsTool comercioExteriorCatalogs() {
     return comercioExteriorCatalogs;
   }
 
+  public NominaCatalogsTool nominaCatalogs() {
+    return nominaCatalogs;
+  }
+
   public ToolsResource tools() {
     return tools;
   }

src/main/java/io/facturapi/tools/NominaCatalogsTool.java

@@ -0,0 +1,25 @@
+package io.facturapi.tools;
+
+import com.fasterxml.jackson.core.type.TypeReference;
+import io.facturapi.http.FacturapiHttpClient;
+import io.facturapi.models.CatalogItem;
+import io.facturapi.models.SearchResult;
+import java.util.Map;
+
+public class NominaCatalogsTool {
+  private final FacturapiHttpClient client;
+
+  public NominaCatalogsTool(FacturapiHttpClient client) {
+    this.client = client;
+  }
+
+  /** Searches payroll deduction types. */
+  public SearchResult<CatalogItem> searchDeductions(Map<String, ?> params) {
+    return client.get("/catalogs/deductions", params, new TypeReference<SearchResult<CatalogItem>>() {});
+  }
+
+  /** Searches payroll perception types. */
+  public SearchResult<CatalogItem> searchPerceptions(Map<String, ?> params) {
+    return client.get("/catalogs/perceptions", params, new TypeReference<SearchResult<CatalogItem>>() {});
+  }
+}