API SOAP¶

Referencia de los 3 endpoints SOAP que TiFacturaOnlineNext expone (los que consume a AFIP están en Cliente AFIP). El enfoque es contract-first (SPEC-008): el WSDL es la fuente de verdad, y un test bloqueante garantiza que el WSDL servido no se desvíe del baseline de producción. Para el porqué del ciclo, mirá El ciclo de facturación.

Stack¶

Los 3 servicios¶

Los publica CxfSoapConfig (com.tipre.tifacturaonlinemanager.config) como tres beans Endpoint. El CXFServlet se monta en cxf.path = /TiFacturaOnlineManagerWS, y cada endpoint se publica en su sub-path, de modo que las URLs resultantes coinciden con las de producción.

Cada bean fija setWsdlLocation("wsdl/X.wsdl") para servir el WSDL exacto del baseline de producción (no el que CXF regeneraría) — es la vía más segura para que el diff bloqueante dé vacío.

@Bean
public Endpoint trxWsEndpoint(Bus bus, FacturacionService facturacionService) {
    EndpointImpl ep = new EndpointImpl(bus, new TrxWsEndpoint(facturacionService));
    ep.setWsdlLocation("wsdl/TrxWS.wsdl");
    ep.publish("/TrxWS");
    return ep;
}

Cada endpoint implementa una SEI generada por wsdl2java (interfaz endpointInterface) y está anotado @BindingType(SOAPBinding.SOAP12HTTP_BINDING).

Operaciones¶

Las faults estándar de cada operación de negocio son: AfipGeneralException, ParametroRequeridoException, TimeOutException, GeneralException. getVersion y setMockActive no declaran faults; sendEmail y getPdf declaran solo ParametroRequeridoException y GeneralException.

TrxWS (TrxWsEndpoint)¶

Endpoint de operaciones sobre transacciones (comprobantes) emitidas offline con CAEA.

CaeaWS (CaeaWsEndpoint)¶

Endpoint del flujo CAEA orientado al POS.

TiFacturaOnlineManagerWS (TfomWsEndpoint)¶

El endpoint principal: emisión de CAE, consultas y puntos de venta.

El gate del WSDL (WsdlDiffGateTest)¶

SPEC-008 paso 4: un test bloqueante que garantiza que el WSDL servido por CXF no se desvía del contrato de producción. Vive en src/test/java/.../WsdlDiffGateTest.java.

Levanta el app (RANDOM_PORT), baja /TiFacturaOnlineManagerWS/{servicio}?wsdl de cada endpoint y lo compara semánticamente (XMLUnit) contra el baseline congelado en baseline/wsdl/. Normalización aplicada:

• Ignora whitespace, comentarios y prefijos de namespace (checkForSimilar).
• Empareja message/operation/etc. por name (el orden no es semántico).
• Ignora el atributo location de soap:address (host/puerto cambian entre prod y runtime).

Cualquier otra diferencia = test rojo = build rojo. Si hay diff, deja el WSDL servido en target/wsdl-served/ para inspección.

Generación de stubs (cxf-codegen-plugin)¶

Las SEI y los tipos JAXB se generan en build-time con org.apache.cxf:cxf-codegen-plugin (goal wsdl2java), en la fase generate-sources, hacia target/generated-sources/cxf.

Como los 3 WSDL comparten el mismo targetNamespace, se mapea un paquete por servicio (-p ...=...gen.trx, etc.) para que no colisionen las operaciones comunes (getVersion, setMockActive).

# Regenerar las SEI desde los WSDL (corre solo, dentro del build)
mvn generate-sources

# Build completo + el gate bloqueante del WSDL
mvn test

Por dónde seguir¶

• Cliente AFIP — los servicios SOAP que este backend consume.
• API REST — los endpoints REST (incluida la variante REST de getCaea).
• El ciclo de facturación — cuándo entra cada operación.