Consultar suscripciones

Este método permite consultar las suscripciones registradas para un emisor a partir de su identificador único (GuidEmpresa). La respuesta contiene las cantidades contratadas y consumidas, el saldo disponible, las fechas de vigencia y el estado de cada suscripción.

GET https://micro.conexusit.com/corp/demo/api/Service.svc/ConsultarSuscripcion/{guidEmpresa}

Endpoint

Dato	Valor
Método HTTP	`GET`
Operación	`ConsultarSuscripcion`

Parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`GuidEmpresa`	`string`	Sí	Identificador único de la empresa cuyas suscripciones se desean consultar.

Ejemplo de solicitud

Ambiente: demostración.

GET https://micro.conexusit.com/corp/demo/api/Service.svc/ConsultarSuscripcion/e144e070dffb4b90a0f93bb192b0ea30

Consultar suscripciones en el ambiente de demostración

Ejemplo de solicitud a ConsultarSuscripcion

Estructura de la respuesta

Campo	Descripción
`Estado`	Estado del resultado de la consulta.
`DetalleEstado`	Información adicional sobre el resultado de la operación o los posibles errores.
`Suscripciones`	Lista de suscripciones asociadas al emisor. Ver `SuscripcionType`.

Cada suscripción incluye su paquete de documentos (DocumentPackageType), con los límites por servicio (DocumentPackageLimitType) y sus códigos de tipo de servicio.

Consideraciones importantes

TotalQuantity indica el cupo total configurado; ConsumedQuantity, el consumo registrado, y RemainingQuantity, el saldo disponible.
StartDate y EndDate permiten identificar el período de vigencia configurado.
Los valores de Status deben interpretarse de acuerdo con las reglas y los estados definidos por el servicio.

using System.Net.Http; // Ambiente de pruebas. var baseUrl = "https://micro.conexusit.com/corp/demo/api/Service.svc"; var guidEmpresa = "e144e070dffb4b90a0f93bb192b0ea30"; var url = $"{baseUrl}/ConsultarSuscripcion/{guidEmpresa}"; using var client = new HttpClient(); var response = await client.GetAsync(url); var result = await response.Content.ReadAsStringAsync(); Console.WriteLine((int)response.StatusCode); Console.WriteLine(result);

<?php // Ambiente de pruebas. $baseUrl = "https://micro.conexusit.com/corp/demo/api/Service.svc"; $guidEmpresa = "e144e070dffb4b90a0f93bb192b0ea30"; $url = "{$baseUrl}/ConsultarSuscripcion/{$guidEmpresa}"; $ch = curl_init($url); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Accept: application/json"], CURLOPT_TIMEOUT => 60, ]); $response = curl_exec($ch); if ($response === false) { die("Error cURL: " . curl_error($ch)); } $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); echo $status . PHP_EOL; echo $response;

import requests # Ambiente de pruebas. base_url = "https://micro.conexusit.com/corp/demo/api/Service.svc" guid_empresa = "e144e070dffb4b90a0f93bb192b0ea30" url = f"{base_url}/ConsultarSuscripcion/{guid_empresa}" response = requests.get(url, headers={"Accept": "application/json"}, timeout=60) print(response.status_code) print(response.json())

{ "ConsultarSuscripcionResult": { "Estado": "...", "DetalleEstado": "...", "Suscripciones": [ { "IssuerId": 0, "TotalQuantity": 0, "ConsumedQuantity": 0, "RemainingQuantity": 0, "StartDate": "yyyy-MM-dd", "EndDate": "yyyy-MM-dd", "Status": "...", "DocumentPackage": { "IntegratedSystemId": 0, "BusinessPartnerId": 0, "TotalQuantity": 0, "ConsumedQuantity": 0, "RemainingQuantity": 0, "StartDate": "yyyy-MM-dd", "EndDate": "yyyy-MM-dd", "Status": "...", "DocumentPackageLimit": [ { "ServiceTypeCode": "FE", "TotalQuantity": 0, "ConsumedQuantity": 0, "RemainingQuantity": 0, "StartDate": "yyyy-MM-dd", "EndDate": "yyyy-MM-dd", "Status": "..." } ] } } ] } }

Endpoint​

Parámetros de entrada​

Ejemplo de solicitud​

Estructura de la respuesta​

Consideraciones importantes​

Endpoint

Parámetros de entrada

Ejemplo de solicitud

Estructura de la respuesta

Consideraciones importantes