Protocolos soportados: SOAP y REST

ZetaSoftware expone sus APIs bajo dos protocolos: SOAP y REST. REST es el protocolo oficial y recomendado para todas las integraciones nuevas. El soporte SOAP se mantiene exclusivamente para integraciones existentes y se encuentra en proceso de descontinuación.

SOAP (soporte limitado — en descontinuación)

SOAP es un protocolo basado en XML con estructura de mensaje fija (encabezado + cuerpo) y descripción de servicios mediante archivos WSDL.

Todas las integraciones nuevas deben implementarse sobre REST.
Las integraciones SOAP existentes continuarán operando, pero no recibirán mantenimiento futuro.

REST (protocolo recomendado)

REST es el estándar oficial de ZetaSoftware. Utiliza métodos HTTP estándar (GET, POST, PUT, DELETE) y transfiere datos en formato JSON.

Ejemplo de request y response

El siguiente ejemplo consulta los saldos pendientes de un cliente específico mediante el endpoint RESTFacturaClienteV4QuerySaldosPendientes.

Request — Python

import requests, json

# Credenciales y parámetros
desarrollador_codigo = "TU_CODIGO_DESARROLLADOR"
desarrollador_clave  = "TU_CLAVE_DESARROLLADOR"
empresa_codigo       = "TU_CODIGO_EMPRESA"
empresa_clave        = "TU_CLAVE_EMPRESA"
cliente_codigo       = "CODIGO_DE_CLIENTE_A_CONSULTAR"

payload = {
    "QuerySaldosPendientesIn": {
        "Connection": {
            "DesarrolladorCodigo": desarrollador_codigo,
            "DesarrolladorClave":  desarrollador_clave,
            "EmpresaCodigo":       empresa_codigo,
            "EmpresaClave":        empresa_clave,
            "RolCodigo":           "1"
        },
        "Data": {
            "Page": "1",
            "Filters": {
                "ClienteCodigo": cliente_codigo
            }
        }
    }
}

url     = "https://api.zetasoftware.com/rest/APIs/RESTFacturaClienteV4QuerySaldosPendientes"
headers = {"Content-Type": "application/json"}

r = requests.post(url, headers=headers, json=payload)

if r.ok:
    print(json.dumps(r.json(), indent=2, ensure_ascii=False))
else:
    print(f"Error {r.status_code}: {r.text}")

Response

{
  "QuerySaldosPendientesOut": {
    "IsLastPage": true,
    "Succeed": true,
    "Response": [
      {
        "ClienteCodigo":          "C123",
        "ClienteNombre":          "Cliente prueba API",
        "ClienteRazonSocial":     "Cliente prueba API",
        "ComprobanteAbreviacion": "e-Vta.Cred",
        "ComprobanteCodigo":      701,
        "ComprobanteNombre":      "Venta Crédito (CFE)",
        "ComprobanteTipo":        1,
        "ComprobanteTipoNombre":  "Venta Crédito",
        "CondicionCodigo":        "",
        "CondicionNombre":        "",
        "Emitido":                "N",
        "Fecha":                  "2025-07-10",
        "LocalCodigo":            1,
        "LocalNombre":            "Casa Central",
        "MonedaCodigo":           1,
        "MonedaNombre":           "Pesos",
        "MonedaSimbolo":          "$",
        "Notas":                  "",
        "Numero":                 "0",
        "RegistroId":             "5469",
        "Saldo":                  "61.00",
        "SaldoSigno":             "61.00",
        "Serie":                  "",
        "Total":                  "61.00",
        "TotalSigno":             "61.00"
      }
    ]
  }
}