Develop

.github/workflows/publish-maven.yml

@@ -0,0 +1,40 @@
+name: Publish to Maven Central
+
+on:
+  push:
+    tags:
+      - 'release-*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 11
+        uses: actions/setup-java@v4
+        with:
+          java-version: '11'
+          distribution: 'temurin'
+          cache: maven
+          server-id: central
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_PASSWORD
+
+      - name: Import GPG key
+        uses: crazy-max/ghaction-import-gpg@v6
+        with:
+          gpg_private_key: ${{ secrets.GPG_PRIVATE_KEY }}
+          passphrase: ${{ secrets.GPG_PASSPHRASE }}
+
+      - name: Build and verify
+        run: mvn clean verify -DskipTests
+
+      - name: Publish to Maven Central
+        run: mvn deploy -Prelease -DskipTests
+        env:
+          MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.MAVEN_PASSWORD }}
+          GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}

CLAUDE.md

@@ -0,0 +1,103 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+SW-JAVA is a Java SDK for consuming SW sapien® CFDI (Mexican electronic invoicing) services. It provides authentication, stamping (timbrado), cancellation, validation, and other tax document operations.
+
+## Build Commands
+
+```bash
+# Build the project
+mvn clean package
+
+# Build with dependencies JAR
+mvn clean package assembly:single
+
+# Run all tests
+mvn test
+
+# Run a single test class
+mvn test -Dtest=SWAuthenticationServiceTest
+
+# Run a specific test method
+mvn test -Dtest=SWAuthenticationServiceTest#testAuth
+
+# Build for release (includes GPG signing)
+mvn clean deploy -Prelease
+```
+
+## Test Environment Variables
+
+Tests require the following environment variables:
+- `SDKTEST_USER` - SW account username
+- `SDKTEST_PASSWORD` - SW account password
+- `SDKTEST_TOKEN` - SW authentication token
+
+Test endpoints:
+- Services URL: `https://services.test.sw.com.mx`
+- API URL: `https://api.test.sw.com.mx`
+
+## Architecture
+
+### Service Layer (`Services/`)
+All services extend the abstract `SWService` base class which handles:
+- Authentication (user/password or token-based)
+- Token auto-refresh based on expiration
+- Proxy support
+- TLS 1.2 enforcement
+
+Key services:
+- `SWAuthenticationService` - Token generation
+- `SWStampService` / `SWStampServiceV2` / `SWStampServiceV4` - CFDI stamping
+- `SWIssueService` / `SWIssueServiceV2` / `SWIssueServiceV4` - CFDI sealing and stamping
+- `SWCancelationService` - Invoice cancellation
+- `SWValidateService` - CFDI validation
+- `SWBalanceAccountService` - Account balance queries
+- `SWPdfService` - PDF generation from CFDI
+- `SWStorageService` - Document storage operations
+
+### Request/Response Pattern (`Utils/Requests/`, `Utils/Responses/`)
+Each service has corresponding request and response classes:
+- Request classes handle HTTP communication to SW APIs
+- Response classes model the API responses with status, data, and error information
+- Response versions (V1-V4) provide different levels of detail for stamping operations
+
+### Response Versions for Stamping
+| Version | Response Content |
+|---------|------------------|
+| V1 | Timbre fiscal digital (TFD) only |
+| V2 | TFD + timbrado CFDI |
+| V3 | Timbrado CFDI only |
+| V4 | All stamping data |
+
+### Exceptions (`Exceptions/`)
+- `AuthException` - Authentication failures
+- `GeneralException` - General API errors
+- `ValidationException` - Input validation errors
+
+### Helpers (`Utils/Helpers/`)
+- `BuildResponseV1-V4` - Response builders for different stamp versions
+- `RequestHelper` / `RequestZipHelper` - HTTP request utilities
+- `Validations` - Input validation utilities
+
+## CFDI Types Supported
+
+Test resources in `src/test/resources/CFDI40/` show supported document types:
+- Standard invoices (Ingreso)
+- Payments (Pagos20)
+- Payroll (Nomina12)
+- Foreign trade (ComercioExterior11)
+- Transportation (CartaPorte20)
+- Retentions (Retenciones20)
+- Donations (Donatarias11)
+- Other complements (INE, Addenda, etc.)
+
+## Dependencies
+
+The SDK uses:
+- Apache HttpClient 5 for HTTP operations
+- org.json and Gson for JSON processing
+- JUnit Jupiter 5 for testing
+- External dependency `sw-resources-java` for CFDI cadena original generation

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lunasoft®
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.