WSGetFacturas

Consulta facturas del sistema de facturación GeoTareas desde sistemas legados. Soporta filtros por número, tarea, rango de fechas y entidades.

Target route

POST /apidev/legacy/WSGetFacturas

Status

New implementation required — No existe adapter actual. El diseño debe basarse en la evidencia del Java generado (wsgetfacturas.java), no en el helper txt que tiene información incorrecta.

---

Authentication

{
  "WSAutorizacion": {
    "Guid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "Usuario": "usuario@empresa.com",
    "Password": "contraseña"
  }
}

---

Request body

Filtro mínimo requerido

Al menos uno de los tres filtros principales debe estar presente: NroFactura, IdExternoTarea, o el par FechaDesde + FechaHasta.

Campo	Tipo	Descripción
WSAutorizacion	object	Credenciales de autenticación legacy
NroFactura	string	Número de factura específico
IdExternoTarea	string	ID externo de la tarea relacionada
FechaDesde	string (YYYY-MM-DD)	Fecha de inicio del rango
FechaHasta	string (YYYY-MM-DD)	Fecha de fin del rango
Prestador	string	Filtrar por nombre o ID de prestador
Personal	string	Filtrar por nombre o ID de personal
Movil	string	Filtrar por patente o ID del vehículo
Procedencia	string	Filtrar por nombre o ID de procedencia
Usuario	string	Filtrar por nombre o ID de usuario
Moneda	string	Filtrar por código de moneda (ej: "UYU")
Tarifa	string	Filtrar por nombre o ID de tarifa
Estado	string	Filtrar por código de estado (ej: "PENDIENTE")
Limit	integer	Máximo de registros (default: 50)
Offset	integer	Desplazamiento para paginación

{
  "WSAutorizacion": { "Guid": "...", "Usuario": "...", "Password": "..." },
  "FechaDesde": "2026-04-01",
  "FechaHasta": "2026-04-03",
  "Estado": "PENDIENTE",
  "Limit": 50
}

---

Response body

Campo	Tipo	Descripción
Resultado	string	"OK" o código de error
Mensaje	string	Descripción del resultado
Facturas	array	Lista de facturas
Facturas[].NroFactura	string	Número de factura
Facturas[].Fecha	string	Fecha de la factura
Facturas[].Estado	string	Estado de la factura
Facturas[].Tipo	string	"PAGAR" o "COBRAR"
Facturas[].Moneda	string	Código de moneda
Facturas[].Tarifa	string	Nombre de la tarifa
Facturas[].Prestador	string	Nombre del prestador
Facturas[].Movil	string	Patente del vehículo
Facturas[].NroServicio	string	Número del servicio relacionado
Facturas[].Subtotal	number	Subtotal sin impuestos
Facturas[].Impuesto	number	Total de impuestos
Facturas[].Total	number	Total con impuestos
Facturas[].Conceptos	array	Líneas de detalle de la factura

{
  "Resultado": "OK",
  "Mensaje": "",
  "Facturas": [
    {
      "NroFactura": "001-0001",
      "Fecha": "2026-04-03T15:02:00",
      "Estado": "PENDIENTE",
      "Tipo": "PAGAR",
      "Moneda": "UYU",
      "Tarifa": "Tarifa General - Prestador",
      "Prestador": "Taller Sanca",
      "Movil": "ABC 1234",
      "NroServicio": "103878",
      "Subtotal": 900.00,
      "Impuesto": 198.00,
      "Total": 1098.00,
      "Conceptos": [
        {
          "Concepto": "Movida",
          "Cantidad": 1.0,
          "PrecioUnitario": 900.00,
          "Subtotal": 900.00,
          "Impuesto": 198.00,
          "Total": 1098.00
        }
      ]
    }
  ]
}

---

Migration note

Requiere implementación nueva. Los filtros nominales (Prestador, Personal, Movil, etc.) resuelven IDs por nombre antes de consultar la BD — esta lógica de resolución debe replicarse.

Pasos de implementación:

1. Validar que al menos un filtro principal esté presente
2. Resolver filtros nominales → IDs internos
3. Construir query paramétrica sobre las tablas de facturación
4. Devolver en formato legacy WSSDTFactura

Referencia de implementación

Para la Wave 12 de la API pública existe una especificación completa de los endpoints de facturación modernos que puede servir de guía: ver Billing API.

---

Related

• WSAltaServicio — crea servicios, de los cuales se generan facturas
• Billing API — Invoices