@ramiidv/arca-agro 0.2.0 → 0.3.0

package/dist/validation.js

@@ -1,145 +1,42 @@
-import { ArcaValidationError, } from '@ramiidv/arca-common';
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-function validateCuitField(value, fieldName, errors) {
-    if (value == null) {
-        errors.push({ field: fieldName, message: `${fieldName} es requerido`, value });
-        return;
-    }
-    const str = String(value);
-    if (!/^\d{11}$/.test(str)) {
-        errors.push({
-            field: fieldName,
-            message: `${fieldName} debe tener exactamente 11 digitos numericos`,
-            value,
-        });
+import { encodeRequest } from './schema.js';
+import { AUTORIZAR_AUTOMOTOR, AUTORIZAR_FERROVIARIA } from './cpe-schemas.js';
+import { AJUSTE_UNIFICADO, LIQUIDACION_AUTORIZAR } from './lpg-schemas.js';
+/** @internal `origen` debe tener `operador` o `productor`. */
+export function requireOrigen(input, errors) {
+    const origen = input['origen'];
+    if (origen !== null && typeof origen === 'object') {
+        const o = origen;
+        if (o['operador'] == null && o['productor'] == null) {
+            errors.push({ field: 'origen', message: 'origen: se debe informar operador o productor', value: origen });
+        }
     }
 }
-function requirePositive(value, fieldName, errors) {
-    if (value == null) {
-        errors.push({ field: fieldName, message: `${fieldName} es requerido`, value });
-        return;
-    }
-    if (typeof value !== 'number' || value <= 0) {
-        errors.push({
-            field: fieldName,
-            message: `${fieldName} debe ser un numero mayor a 0`,
-            value,
-        });
+/** @internal Las consultas de una CPE necesitan `cartaPorte` o `nroCTG`. */
+export function requireCartaPorteOCtg(input, errors) {
+    if (input['cartaPorte'] == null && input['nroCTG'] == null) {
+        errors.push({ field: 'cartaPorte', message: 'se debe informar cartaPorte o nroCTG' });
     }
 }
-function requireNonNegative(value, fieldName, errors) {
-    if (value == null) {
-        errors.push({ field: fieldName, message: `${fieldName} es requerido`, value });
-        return;
-    }
-    if (typeof value !== 'number' || value < 0) {
-        errors.push({
-            field: fieldName,
-            message: `${fieldName} debe ser un numero mayor o igual a 0`,
-            value,
-        });
+/** @internal El ajuste unificado necesita `ajusteCredito` y/o `ajusteDebito`. */
+export function requireAjuste(input, errors) {
+    if (input['ajusteCredito'] == null && input['ajusteDebito'] == null) {
+        errors.push({ field: 'ajusteCredito', message: 'se debe informar ajusteCredito y/o ajusteDebito' });
     }
 }
-function throwIfErrors(errors, context) {
-    if (errors.length > 0) {
-        throw new ArcaValidationError(`Validacion de ${context} fallida: ${errors.map((e) => e.message).join('; ')}`, errors, context);
-    }
+/** Valida una solicitud de `autorizarCPEAutomotor`. @throws ArcaValidationError */
+export function validateAutorizarCPEAutomotor(params) {
+    encodeRequest(params, AUTORIZAR_AUTOMOTOR, 'autorizarCPEAutomotor', requireOrigen);
 }
-// ---------------------------------------------------------------------------
-// CPE Validation
-// ---------------------------------------------------------------------------
-/**
- * Valida los datos de una Carta de Porte Electronica antes de enviar al servicio WSCPE.
- *
- * Campos validados:
- * - cuitTitularCartaPorte: 11 digitos
- * - sucursal: > 0
- * - nroOrden: >= 0
- * - codGrano: > 0
- * - pesoNeto: > 0
- * - cuitDestino: 11 digitos
- * - codLocalidadDestino: > 0
- * - cuitTransportista: 11 digitos
- *
- * @throws ArcaValidationError con detalles de todos los campos invalidos.
- */
-export function validateCPE(cpe) {
-    const errors = [];
-    validateCuitField(cpe.cuitTitularCartaPorte, 'cuitTitularCartaPorte', errors);
-    requirePositive(cpe.sucursal, 'sucursal', errors);
-    requireNonNegative(cpe.nroOrden, 'nroOrden', errors);
-    requirePositive(cpe.codGrano, 'codGrano', errors);
-    requirePositive(cpe.pesoNeto, 'pesoNeto', errors);
-    validateCuitField(cpe.cuitDestino, 'cuitDestino', errors);
-    requirePositive(cpe.codLocalidadDestino, 'codLocalidadDestino', errors);
-    validateCuitField(cpe.cuitTransportista, 'cuitTransportista', errors);
-    throwIfErrors(errors, 'CartaPorteAutomotor');
+/** Valida una solicitud de `autorizarCPEFerroviaria`. @throws ArcaValidationError */
+export function validateAutorizarCPEFerroviaria(params) {
+    encodeRequest(params, AUTORIZAR_FERROVIARIA, 'autorizarCPEFerroviaria');
 }
-// ---------------------------------------------------------------------------
-// CTG Validation
-// ---------------------------------------------------------------------------
-/**
- * Valida los datos de una solicitud de CTG antes de enviar al servicio WSCTG.
- *
- * Campos validados:
- * - nroCartaPorte: > 0
- * - codEspecie: > 0
- * - pesoNeto: > 0
- * - cuitDestino: 11 digitos
- * - cuitDestinatario: 11 digitos
- * - codLocalidadOrigen: > 0
- * - codLocalidadDestino: > 0
- * - codCosecha: > 0
- *
- * @throws ArcaValidationError con detalles de todos los campos invalidos.
- */
-export function validateCTG(ctg) {
-    const errors = [];
-    requirePositive(ctg.nroCartaPorte, 'nroCartaPorte', errors);
-    requirePositive(ctg.codEspecie, 'codEspecie', errors);
-    requirePositive(ctg.pesoNeto, 'pesoNeto', errors);
-    validateCuitField(ctg.cuitDestino, 'cuitDestino', errors);
-    validateCuitField(ctg.cuitDestinatario, 'cuitDestinatario', errors);
-    requirePositive(ctg.codLocalidadOrigen, 'codLocalidadOrigen', errors);
-    requirePositive(ctg.codLocalidadDestino, 'codLocalidadDestino', errors);
-    requirePositive(ctg.codCosecha, 'codCosecha', errors);
-    if (ctg.cuitTransportista != null) {
-        validateCuitField(ctg.cuitTransportista, 'cuitTransportista', errors);
-    }
-    throwIfErrors(errors, 'SolicitudCTG');
+/** Valida una solicitud de `liquidacionAutorizar`. @throws ArcaValidationError */
+export function validateLiquidacion(params) {
+    encodeRequest(params, LIQUIDACION_AUTORIZAR, 'liquidacionAutorizar');
 }
-// ---------------------------------------------------------------------------
-// Liquidacion Validation
-// ---------------------------------------------------------------------------
-/**
- * Valida los datos de una liquidacion primaria de granos antes de enviar al servicio WSLPG.
- *
- * Campos validados:
- * - cuitComprador: 11 digitos
- * - cuitVendedor: 11 digitos
- * - codGrano: > 0
- * - pesoNeto: > 0
- * - precioRefTn: >= 0 (si presente)
- *
- * @throws ArcaValidationError con detalles de todos los campos invalidos.
- */
-export function validateLiquidacion(liq) {
-    const errors = [];
-    validateCuitField(liq.cuitComprador, 'cuitComprador', errors);
-    validateCuitField(liq.cuitVendedor, 'cuitVendedor', errors);
-    requirePositive(liq.codGrano, 'codGrano', errors);
-    requirePositive(liq.pesoNeto, 'pesoNeto', errors);
-    if (liq.precioRefTn != null) {
-        requireNonNegative(liq.precioRefTn, 'precioRefTn', errors);
-    }
-    if (liq.cuitCorredorVendedor != null) {
-        validateCuitField(liq.cuitCorredorVendedor, 'cuitCorredorVendedor', errors);
-    }
-    if (liq.cuitCorredorComprador != null) {
-        validateCuitField(liq.cuitCorredorComprador, 'cuitCorredorComprador', errors);
-    }
-    throwIfErrors(errors, 'Liquidacion');
+/** Valida una solicitud de `liquidacionAjustarUnificado`. @throws ArcaValidationError */
+export function validateAjusteUnificado(params) {
+    encodeRequest(params, AJUSTE_UNIFICADO, 'liquidacionAjustarUnificado', requireAjuste);
 }
 //# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAEpB,MAAM,sBAAsB,CAAC;AAI9B,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,iBAAiB,CACxB,KAAc,EACd,SAAiB,EACjB,MAA+B;IAE/B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,GAAG,SAAS,8CAA8C;YACnE,KAAK;SACN,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,KAAc,EACd,SAAiB,EACjB,MAA+B;IAE/B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,GAAG,SAAS,+BAA+B;YACpD,KAAK;SACN,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAc,EACd,SAAiB,EACjB,MAA+B;IAE/B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,GAAG,SAAS,uCAAuC;YAC5D,KAAK;SACN,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAA+B,EAAE,OAAe;IACrE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,mBAAmB,CAC3B,iBAAiB,OAAO,aAAa,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC9E,MAAM,EACN,OAAO,CACR,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,GAAwB;IAClD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,iBAAiB,CAAC,GAAG,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,CAAC,CAAC;IAC9E,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAClD,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACrD,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAClD,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAClD,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1D,eAAe,CAAC,GAAG,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACxE,iBAAiB,CAAC,GAAG,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAEtE,aAAa,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,GAAiB;IAC3C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,eAAe,CAAC,GAAG,CAAC,aAAa,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IAC5D,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACtD,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAClD,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC1D,iBAAiB,CAAC,GAAG,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;IACpE,eAAe,CAAC,GAAG,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,CAAC,CAAC;IACtE,eAAe,CAAC,GAAG,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACxE,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAEtD,IAAI,GAAG,CAAC,iBAAiB,IAAI,IAAI,EAAE,CAAC;QAClC,iBAAiB,CAAC,GAAG,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACxE,CAAC;IAED,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACxC,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAgB;IAClD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,iBAAiB,CAAC,GAAG,CAAC,aAAa,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IAC9D,iBAAiB,CAAC,GAAG,CAAC,YAAY,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAC5D,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAClD,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAElD,IAAI,GAAG,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;QAC5B,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,GAAG,CAAC,oBAAoB,IAAI,IAAI,EAAE,CAAC;QACrC,iBAAiB,CAAC,GAAG,CAAC,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,GAAG,CAAC,qBAAqB,IAAI,IAAI,EAAE,CAAC;QACtC,iBAAiB,CAAC,GAAG,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC;IAED,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAI3E,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,KAA8B,EAAE,MAA+B;IAC3F,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,CAAC,GAAG,MAAiC,CAAC;QAC5C,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,+CAA+C,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5G,CAAC;IACH,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CAAC,KAA8B,EAAE,MAA+B;IACnG,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,KAA8B,EAAE,MAA+B;IAC3F,IAAI,KAAK,CAAC,eAAe,CAAC,IAAI,IAAI,IAAI,KAAK,CAAC,cAAc,CAAC,IAAI,IAAI,EAAE,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAAC,CAAC;IACtG,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,6BAA6B,CAAC,MAAmC;IAC/E,aAAa,CAAC,MAAM,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,aAAa,CAAC,CAAC;AACrF,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,+BAA+B,CAAC,MAAqC;IACnF,aAAa,CAAC,MAAM,EAAE,qBAAqB,EAAE,yBAAyB,CAAC,CAAC;AAC1E,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,MAAkC;IACpE,aAAa,CAAC,MAAM,EAAE,qBAAqB,EAAE,sBAAsB,CAAC,CAAC;AACvE,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,uBAAuB,CAAC,MAA6B;IACnE,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,aAAa,CAAC,CAAC;AACxF,CAAC"}

package/llms.txt

@@ -1,187 +1,106 @@
-# @ramiidv/arca-agro - Technical Reference
+# @ramiidv/arca-agro - Technical Reference (v0.3.0)
 
 ## Overview
 
-TypeScript SDK for ARCA (Argentina's tax authority, formerly AFIP) agricultural web services. Bundles three SOAP services into a single package with automatic WSAA authentication.
+TypeScript SDK for ARCA (Argentina's tax authority, formerly AFIP) agricultural SOAP web services, with automatic WSAA authentication (via @ramiidv/arca-common ^0.4.0).
 
-- **WSCPE** - Carta de Porte Electrónica: electronic bill of lading for grain transport
-- **WSCTG** - Código de Trazabilidad de Granos: grain traceability codes
-- **WSLPG** - Liquidación Primaria de Granos: primary grain settlement and certification
+- WSCPE - Carta de Porte Electrónica (grain bill of lading; road "automotor" and rail "ferroviaria")
+- WSLPG - Liquidación Primaria de Granos (primary grain settlement) and certificación primaria (cg*)
+
+WSCTG (Código de Trazabilidad de Granos) is NOT included: it was repealed on 2021-11-01 (RG 5017/2021) and its endpoints return 404. The CTG number is now returned by WSCPE (`cabecera.nroCTG`).
 
 ## Architecture
 
 ```
-ArcaAgro (orchestrator)
-├── .cpe  → CpeClient  (WSCPE)  → WSAA service: "wscpe"
-├── .ctg  → CtgClient  (WSCTG)  → WSAA service: "wsctg"
-└── .lpg  → LpgClient  (WSLPG)  → WSAA service: "wslpg"
+ArcaAgro
+├── .cpe → CpeClient (WSCPE) → WSAA service "wscpe"
+└── .lpg → LpgClient (WSLPG) → WSAA service "wslpg"
 ```
 
-All shared utilities (WsaaClient, afipSoapCall, errors, types) come from `@ramiidv/arca-common`. No duplication.
-
-## WSAA Service Identifiers
-
-| Service | WSAA ID |
-|---------|---------|
-| WSCPE   | `wscpe` |
-| WSCTG   | `wsctg` |
-| WSLPG   | `wslpg` |
-
-## Endpoints
-
-### WSCPE
-- Testing: `https://fwshomo.afip.gov.ar/wscpe/services/soap`
-- Production: `https://serviciosjava.afip.gob.ar/wscpe/services/soap`
-
-### WSCTG
-- Testing: `https://fwshomo.afip.gov.ar/wsctg/services/CTGService_v4.0`
-- Production: `https://serviciosjava.afip.gob.ar/wsctg/services/CTGService_v4.0`
-
-### WSLPG
-- Testing: `https://fwshomo.afip.gov.ar/wslpg/LpgService`
-- Production: `https://serviciosjava.afip.gob.ar/wslpg/LpgService`
-
-## API Methods
-
-### agro.cpe.* (WSCPE)
-
-| Method | Description |
-|--------|-------------|
-| `autorizarCPEAutomotor(cpe)` | Authorize electronic bill of lading for road transport |
-| `confirmadoArriboCPE(params)` | Confirm arrival at destination |
-| `rechazoCPE(params)` | Reject a CPE |
-| `anularCPE(params)` | Cancel a CPE |
-| `editarCPE(params)` | Edit fields of an authorized CPE |
-| `informarContingencia(params)` | Report a contingency on a CPE |
-| `consultarCPE(params)` | Query CPEs by search criteria |
-| `consultarCPEPorDestino(params)` | Query CPEs by destination |
-| `consultarUltNroOrden(sucursal)` | Get last order number for a branch |
-| `siguienteNroOrden(sucursal)` | Get next order number (last + 1) |
-| `consultarConstanciaCPEPDF(nroCTG)` | Get CPE certificate as base64 PDF |
-| `dummy()` | Check WSCPE server status |
-
-### agro.ctg.* (WSCTG)
-
-| Method | Description |
-|--------|-------------|
-| `solicitarCTGInicial(solicitud)` | Request initial CTG for grain transport |
-| `confirmarArribo(params)` | Confirm CTG arrival at destination |
-| `rechazarCTG(params)` | Reject a CTG |
-| `anularCTG(params)` | Cancel a CTG |
-| `consultarCTG(params)` | Query CTGs by search criteria |
-| `consultarCTGExcel(params)` | Query CTGs and get Excel export (base64) |
-| `consultarConstanciaCTGPDF(nroCTG)` | Get CTG certificate as base64 PDF |
-| `obtenerCTGActivos()` | Get active (pending) CTGs |
-| `dummy()` | Check WSCTG server status |
-
-### agro.lpg.* (WSLPG)
-
-| Method | Description |
-|--------|-------------|
-| `liquidacionAutorizar(liquidacion)` | Authorize a primary grain settlement |
-| `liquidacionConsultar(params)` | Query authorized settlements |
-| `liquidacionAnular(ptoEmision, nroOrden)` | Cancel a settlement |
-| `liquidacionAjustarUnificado(params)` | Unified adjustment (debit/credit) |
-| `certificacionAutorizar(certificacion)` | Authorize a grain certification |
-| `certificacionAnular(tipo, nro)` | Cancel a certification |
-| `consultarParametros(tipo, params?)` | Query WSLPG parameters (grain types, grades, ports, etc.) |
-| `dummy()` | Check WSLPG server status |
-
-### Global
-
-| Method | Description |
-|--------|-------------|
-| `serverStatus()` | Check all 3 services at once |
-| `clearAuthCache()` | Invalidate all cached WSAA tokens |
-| `on(event, handler)` | Subscribe to SDK events |
-| `off(event, handler)` | Unsubscribe from events |
-
-## Key Types
-
-### Configuration
-
-```ts
-interface ArcaAgroConfig {
-  cuit: number;
-  cert: string;         // PEM certificate
-  key: string;          // PEM private key
-  production?: boolean; // default: false
-  tokenTTLMinutes?: number;    // default: 720
-  requestTimeoutMs?: number;   // default: 30000
-  retries?: number;            // default: 1
-  retryDelayMs?: number;       // default: 1000
-  onEvent?: (event: ArcaEvent) => void;
-}
-```
+Sub-clients are only obtained from `ArcaAgro` (their classes are exported as types). Every public method takes an optional last argument `opts?: { signal?: AbortSignal }`.
 
-### CPE Types
+## Endpoints and namespaces
 
-- `CartaPorteAutomotor` - Input for CPE authorization
-- `CartaPorteResult` - CPE operation result (nroCTG, nroCartaPorte, estado, errores, raw)
-- `ConsultaCPEParams` - CPE query parameters
-- `ConfirmadoArriboCPEParams` - Arrival confirmation input
-- `RechazoAnulacionCPEParams` - Rejection/cancellation input
-- `EditarCPEParams` - Edit input
-- `ContingenciaCPEParams` - Contingency report input
+| Service | Testing | Production | Namespace |
+|---|---|---|---|
+| WSCPE | https://cpea-ws-qaext.afip.gob.ar/wscpe/services/soap | https://cpea-ws.afip.gob.ar/wscpe/services/soap | https://serviciosjava.afip.gob.ar/wscpe/ |
+| WSLPG | https://fwshomo.afip.gov.ar/wslpg/LpgService | https://serviciosjava.afip.gob.ar/wslpg/LpgService | http://serviciosjava.afip.gob.ar/wslpg/ (http!) |
 
-### CTG Types
+SOAP details (from the official WSDLs):
+- WSCPE: request element `<Op>Req` (capitalized operation, e.g. `AutorizarCPEAutomotorReq`), response `<Op>Resp` with a `respuesta` child; SOAPAction = namespace + operation; auth `{token, sign, cuitRepresentada}`; business errors in `respuesta.errores.error[]{codigo,descripcion}`.
+- WSLPG: request/response elements per WSDL (e.g. `liquidacionReq`/`liquidacionResp` → `liqReturn`); SOAPAction = namespace + operation; auth `{token, sign, cuit}`; errors in `errores.error[]` and `erroresFormato.error[]`; info in `eventos.evento[]`.
+- `dummy` (both): empty SOAP Body, no auth.
 
-- `SolicitudCTG` - Input for CTG request
-- `CTGResult` - CTG operation result (nroCTG, estado, vigencia, errores, raw)
-- `ConsultaCTGParams` - CTG query parameters
-- `ConfirmarArriboCTGParams` - Arrival confirmation input
-- `RechazoCTGParams` - Rejection input
-- `AnulacionCTGParams` - Cancellation input
-- `CTGActivosResult` - Active CTGs result
+## Configuration (ArcaAgroConfig extends ArcaBaseConfig)
 
-### LPG Types
+cuit (number|string, validated with check digit), cert, key, production=false, timeout=30000, retries=1 (queries only), retryDelayMs=1000, tokenTTLMinutes=720, ticketStorage, clockOffsetMs, autoClockSkew, loginErrorCooldownMs, fetch, legacyTls, onEvent, endpoints?: { cpe?, lpg?, wsaa? }.
 
-- `Liquidacion` - Input for settlement authorization
-- `LiquidacionResult` - Settlement result (codOperacion, nroOrden, totalPagar, errores, raw)
-- `ConsultaLiquidacionParams` - Settlement query parameters
-- `AjusteUnificadoParams` - Unified adjustment input
-- `Certificacion` - Certification input
-- `CertificacionResult` - Certification result
+## ArcaAgro
 
-## Error Hierarchy
+- `cpe: CpeClient`, `lpg: LpgClient`
+- `serverStatus(opts?)` → `{ cpe: AgroServiceStatus, lpg: AgroServiceStatus }` where `AgroServiceStatus = { ok: true, status: ServerStatus } | { ok: false, error: Error }` (Promise.allSettled)
+- `clearAuthCache(): Promise<void>`
+- `on(type, handler)`, `off(type, handler)`
 
-All errors extend from `ArcaError` (from `@ramiidv/arca-common`):
+## CpeClient (agro.cpe)
 
-- `ArcaAuthError` - WSAA authentication failures
-- `ArcaSoapError` - HTTP/SOAP transport errors (includes `statusCode`)
-- `ArcaServiceError` - Business logic errors from ARCA (includes `errors[]` with code + msg)
-- `ArcaValidationError` - Input validation errors
+Constants: `TIPO_CPE = { AUTOMOTOR: 74, FERROVIARIA: 75, AUTOMOTOR_FLETE_CORTO: 274 }`, `ESTADOS_CPE` (AC, AN, BR, CF, CN, CO, DE, RE, PA, AP, DD, PE, IN, PO).
 
-## Low-Level Clients
+Requests mirror the XSD (`solicitud` content). `CartaPorteId = { tipoCPE, sucursal, nroOrden }`.
 
-For direct control over auth, use the individual clients:
+Emissions (kind 'emision', never retried):
+- `autorizarCPEAutomotor(AutorizarCPEAutomotorParams)` → `CPEAutomotorDetalle` (requires `cabecera.nroCTG`)
+  - params: `{ cabecera: {tipoCP, cuitSolicitante, sucursal, nroOrden}, origen: {operador?|productor?}, correspondeRetiroProductor, esSolicitanteCampo, retiroProductor?, intervinientes?, datosCarga: {codGrano, cosecha, semilla?, pesoBruto, pesoTara}, destino: {cuit, esDestinoCampo, codProvincia, codLocalidad, planta?}, destinatario: {cuit}, transporte: {cuitTransportista, dominio[], fechaHoraPartida, kmRecorrer, codigoTurno?, cuitChofer, tarifa?, cuitPagadorFlete, cuitIntermediarioFlete?, mercaderiaFumigada}, observaciones? }`
+- `autorizarCPEFerroviaria(AutorizarCPEFerroviariaParams)` → `CPEFerroviariaDetalle`
+- returning `CPEResultado { cabecera?, pdf?, metadata? }`: `editarCPEAutomotor`, `editarCPEConfirmadaAutomotor`, `confirmarArriboCPE`, `confirmacionDefinitivaCPEAutomotor`, `descargadoDestinoCPE`, `rechazoCPE`, `anularCPE`, `nuevoDestinoDestinatarioCPEAutomotor`, `regresoOrigenCPEAutomotor`, `desvioCPEAutomotor`, `informarContingencia`, `cerrarContingenciaCPE`, `editarCPEFerroviaria`, `editarCPEConfirmadaFerroviaria`, `confirmacionDefinitivaCPEFerroviaria`, `nuevoDestinoDestinatarioCPEFerroviaria`, `regresoOrigenCPEFerroviaria`, `desvioCPEFerroviaria`
 
-```ts
-import { CpeClient, CtgClient, LpgClient } from '@ramiidv/arca-agro';
-import { WsaaClient } from '@ramiidv/arca-common';
+Queries:
+- `consultarCPEAutomotor({cuitSolicitante?, cartaPorte? | nroCTG?})` → `CPEAutomotorDetalle`
+- `consultarCPEFerroviaria(...)` → `CPEFerroviariaDetalle`
+- `consultaCPEFerroviariaPorNroOperativo(nroOperativo)` → `OperativoFerroviarioCPE`
+- `consultarCPEPorDestino({planta, fechaPartidaDesde, fechaPartidaHasta, tipoCartaPorte?})` → `CPEResumen[]`
+- `consultarCPEPPendientesDeResolucion({perfil: 'S'|'D', planta?})` → `CPEResumen[]`
+- `consultarUltNroOrden(sucursal, tipoCPE)` → number (throws if missing)
+- `siguienteNroOrden(sucursal, tipoCPE)` → number (NOT atomic: concurrent callers get the same number)
+- `consultarProvincias()`, `consultarLocalidadesPorProvincia(codProvincia)`, `consultarTiposGrano()`, `consultarCategoriasSemillas()` → `CodigoDescripcion[]` (`codigo` is string)
+- `consultarPlantas(cuit)` → `PlantaCPE[]`; `consultarLocalidadesProductor(cuit)` → `LocalidadProductorCPE[]`; `consultarVariedadesSemillas(codGrano?)` → `VariedadSemillaCPE[]`
+- `dummy()` → ServerStatus
 
-const cpe = new CpeClient(production, { timeoutMs, retries, retryDelayMs, onEvent });
-const ctg = new CtgClient(production, { ... });
-const lpg = new LpgClient(production, { ... });
-```
+Not supported: derivados granarios (DG, types 284-287), ductos, consultarRenspa, consultarDomiciliosPorCUIT, DG parametrics.
 
-Each client method takes `auth: AgroAuth` as first parameter:
-```ts
-interface AgroAuth { Token: string; Sign: string; Cuit: number; }
-```
+## LpgClient (agro.lpg)
+
+Emissions:
+- `liquidacionAutorizar({ liquidacion: LiquidacionLpg, deducciones?, retenciones?, percepciones? })` → `{ autorizacion: LiquidacionAutorizadaLpg (coe: string), eventos }`
+- `liquidacionAnular(coe)` → `{ coe?, resultado, pdf?, eventos }`
+- `liquidacionAjustarUnificado({ ajusteBase, ajusteCredito?, ajusteDebito? })` → `{ ajusteUnificado (coe: string), eventos }`
+- `cgAutorizar(CgAutorizarParams)` → `{ autorizacion (coe: string), eventos }`
+- `cgSolicitarAnulacion(coe, {pdf?})`, `cgConfirmarAnulacion(coe, {pdf?})` → `{ estadoCertificado, pdf?, eventos }`
+
+Queries:
+- `liquidacionXCoeConsultar(coe, {pdf?})`, `liquidacionXNroOrdenConsultar(ptoEmision, nroOrden)` → `{ liquidacion?, autorizacion, pdf?, eventos }`
+- `liquidacionUltimoNroOrdenConsultar(ptoEmision)`, `cgConsultarUltimoNroOrden(ptoEmision)` → number
+- parametrics → `CodigoDescripcion[]`: `provinciasConsultar`, `localidadXProvinciaConsultar(codProvincia)`, `tipoOperacionXActividadConsultar(nroActLiquida)`, `puertoConsultar`, `tipoActividadConsultar`, `tipoActividadRepresentadoConsultar`, `tipoCertificadoDepositoConsultar`, `tipoRetencionConsultar`, `tipoDeduccionConsultar`, `tipoGranoConsultar`, `codigoGradoReferenciaConsultar`, `campaniasConsultar`; `codigoGradoEntregadoXTipoGranoConsultar(codGrano)` → `GradoEntregadoLpg[]`
+- `dummy()`
+
+`LiquidacionLpg` (LpgLiquidacionBaseType, XSD order): ptoEmision, nroOrden, numeroContrato?, cuitComprador, nroActComprador, nroIngBrutoComprador, codTipoOperacion, esLiquidacionPropia?, esCanje?, codPuerto, desPuertoLocalidad?, codGrano, pesoNetoSinCertificado?, codLocalidadProcedenciaSinCertificado?, codProvProcedenciaSinCertificado?, cuitVendedor, nroIngBrutoVendedor, actuaCorredor?, liquidaCorredor, cuitCorredor?, comisionCorredor?, nroIngBrutoCorredor?, fechaPrecioOperacion, precioRefTn, codGradoRef?, codGradoEnt?, valGradoEnt?, factorEnt?, precioFleteTn, contProteico?, alicIvaOperacion?, campaniaPPal, codLocalidadProcedencia, codProvProcedencia, datosAdicionales?, certificados?[], opcionales?[].
+
+Not supported: lsg*, anticipos, anulación contra documento, ajuste por contrato, cgBuscarCtg, cgBuscarCertConSaldoDisponible, cgConsultarXCoe/XNroOrden, cgInformarCalidad.
+
+## Validation
+
+All requests are validated locally against the XSD before sending (ArcaValidationError with all `details[]`): required fields, unknown fields, ranges/lengths/enums, CUIT check digit (validateCuit), finite numbers, decimals rounded to `fractionDigits`, `xsd:date` (Date | AAAAMMDD | AAAA-MM-DD → AAAA-MM-DD), `xsd:dateTime` (Date → Argentina time -03:00, or ISO string). Exported: `validateAutorizarCPEAutomotor`, `validateAutorizarCPEFerroviaria`, `validateLiquidacion`, `validateAjusteUnificado`.
 
-## Source Files
+## Errors
 
-| File | Purpose |
-|------|---------|
-| `src/constants.ts` | Endpoints, namespaces, WSAA service IDs |
-| `src/types.ts` | All TypeScript interfaces for the 3 services |
-| `src/cpe-client.ts` | Low-level WSCPE SOAP client |
-| `src/ctg-client.ts` | Low-level WSCTG SOAP client |
-| `src/lpg-client.ts` | Low-level WSLPG SOAP client |
-| `src/arca-agro.ts` | Main orchestrator with auto-auth and namespaced API |
-| `src/index.ts` | Public exports |
+- `ArcaValidationError` - invalid input (no request sent)
+- `ArcaAgroServiceError extends ArcaServiceError` - ARCA business errors; `errors[]`, `service`, `method`, `response`
+- `ArcaSoapError` - transport/HTTP/SOAP Fault; `uncertain` for emissions
+- `ArcaAgroResponseError` - response missing a required datum (nroCTG, coe, nroOrden); `uncertain` for emissions
+- `ArcaAuthError`, `ArcaTicketVigenteError` - WSAA
 
-## Dependencies
+## Recovering an uncertain emission
 
-- `@ramiidv/arca-common` (^0.1.0) - WsaaClient, afipSoapCall, errors, types, validators
+- CPE: `consultarUltNroOrden(sucursal, tipoCPE) >= nroOrden` → it was authorized; fetch it with `consultarCPEAutomotor({cartaPorte})`. Otherwise retry with the same nroOrden.
+- LPG: `liquidacionUltimoNroOrdenConsultar(ptoEmision)` + `liquidacionXNroOrdenConsultar`; for anular/ajuste use `liquidacionXCoeConsultar(coe)`.
+- CG: `cgConsultarUltimoNroOrden(ptoEmision)`.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ramiidv/arca-agro",
-  "version": "0.2.0",
-  "description": "SDK para servicios agropecuarios de ARCA (ex AFIP) - WSCPE, WSCTG, WSLPG",
+  "version": "0.3.0",
+  "description": "SDK para servicios agropecuarios de ARCA (ex AFIP) - WSCPE (Carta de Porte Electrónica) y WSLPG (Liquidación Primaria de Granos)",
   "author": "ramiidv",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,7 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
-    "prepublishOnly": "npm run clean && npm run build"
+    "prepublishOnly": "npm run clean && npm run build && npm test"
   },
   "keywords": [
     "arca",
@@ -36,15 +36,14 @@
     "agro",
     "granos",
     "carta-de-porte",
-    "ctg",
     "liquidacion",
     "argentina",
     "wscpe",
-    "wsctg",
     "wslpg",
     "soap",
     "sdk",
-    "typescript"
+    "typescript",
+    "cpe"
   ],
   "repository": {
     "type": "git",
@@ -61,7 +60,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@ramiidv/arca-common": "^0.1.0"
+    "@ramiidv/arca-common": "^0.4.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/dist/ctg-client.d.ts

@@ -1,56 +0,0 @@
-import type { ArcaEvent, ServerStatus } from '@ramiidv/arca-common';
-import type { AgroAuth, SolicitudCTG, CTGResult, ConsultaCTGParams, ConfirmarArriboCTGParams, RechazoCTGParams, AnulacionCTGParams, CTGActivosResult } from './types.js';
-export interface CtgClientOptions {
-    timeoutMs?: number;
-    retries?: number;
-    retryDelayMs?: number;
-    onEvent?: (event: ArcaEvent) => void;
-}
-/**
- * Cliente de bajo nivel para WSCTG (Código de Trazabilidad de Granos).
- * Gestiona CTGs para el seguimiento del transporte de granos.
- */
-export declare class CtgClient {
-    private readonly endpoint;
-    private readonly soapOpts;
-    constructor(production: boolean, opts?: CtgClientOptions);
-    private call;
-    private parseResult;
-    /**
-     * Solicita un CTG inicial para el transporte de granos.
-     */
-    solicitarCTGInicial(auth: AgroAuth, solicitud: SolicitudCTG): Promise<CTGResult>;
-    /**
-     * Confirma el arribo de un CTG en destino.
-     */
-    confirmarArribo(auth: AgroAuth, params: ConfirmarArriboCTGParams): Promise<CTGResult>;
-    /**
-     * Rechaza un CTG.
-     */
-    rechazarCTG(auth: AgroAuth, params: RechazoCTGParams): Promise<CTGResult>;
-    /**
-     * Anula un CTG.
-     */
-    anularCTG(auth: AgroAuth, params: AnulacionCTGParams): Promise<CTGResult>;
-    /**
-     * Consulta CTGs según criterios de búsqueda.
-     */
-    consultarCTG(auth: AgroAuth, params: ConsultaCTGParams): Promise<CTGResult[]>;
-    /**
-     * Consulta CTGs y retorna el resultado en formato Excel (base64).
-     */
-    consultarCTGExcel(auth: AgroAuth, params: ConsultaCTGParams): Promise<string>;
-    /**
-     * Obtiene la constancia PDF de un CTG en base64.
-     */
-    consultarConstanciaCTGPDF(auth: AgroAuth, nroCTG: number): Promise<string>;
-    /**
-     * Obtiene los CTGs activos (pendientes).
-     */
-    obtenerCTGActivos(auth: AgroAuth): Promise<CTGActivosResult>;
-    /**
-     * Verifica el estado de los servidores del WSCTG.
-     */
-    dummy(): Promise<ServerStatus>;
-}
-//# sourceMappingURL=ctg-client.d.ts.map

package/dist/ctg-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ctg-client.d.ts","sourceRoot":"","sources":["../src/ctg-client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAErF,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC;AAED;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4E;gBAEzF,UAAU,EAAE,OAAO,EAAE,IAAI,GAAE,gBAAqB;YAY9C,IAAI;IAYlB,OAAO,CAAC,WAAW;IAiCnB;;OAEG;IACG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAgBtF;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,SAAS,CAAC;IAuB3F;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IAqB/E;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAqB/E;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAenF;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAYnF;;OAEG;IACG,yBAAyB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAchF;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsBlE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;CAcrC"}