Acceso a la documentación y SDK PHP de BlueTech CFE

Este artículo explica dónde consultar la documentación oficial de la API y cómo comenzar a usar el SDK PHP.

1) Documentación web de la API

La documentación técnica para integraciones está disponible en el portal web de documentación.

• URL: https://developers.bluetechsoftware.cloud/
• Secciones principales:

1. REST: endpoints autenticados y de integración.
2. SOAP: operaciones legacy y POS.
3. Guías: ejemplos paso a paso.

Sugerencia de navegación rápida:

• REST: https://developers.bluetechsoftware.cloud/rest/
• SOAP:  https://developers.bluetechsoftware.cloud/soap/
• Guías: https://developers.bluetechsoftware.cloud/guias/

2) SDK PHP oficial

Existe un SDK oficial para consumir la API REST desde PHP.

• Repositorio/código: https://github.com/BlueTech-Software-Uy/bluetech-sdk-cfe-php
• Documentación interna del SDK: https://github.com/BlueTech-Software-Uy/bluetech-sdk-cfe-php/blob/main/docs/README.md

3) Instalación rápida del SDK

Configuración base:

• La baseUrl debe ser el host de CFE, por ejemplo:
  https://cfetesting.bluetechsoftware.cloud/cfe

4) Requisitos para integradores

Antes de consumir API o SDK, se necesita:

1. Usuario y clave de API.
2. URL base del entorno (testing/producción).
3. Empresa habilitada para operar.
4. Permisos necesarios sobre la empresa y endpoints.

5) Recomendación de uso

1. Validar autenticación primero.
2. Probar endpoint de emisión en entorno de testing.
3. Migrar a SDK para estandarizar manejo de token, errores y reintentos.
4. Usar la documentación web como contrato funcional y el SDK como acelerador de implementación.

6) Soporte

Si no podés acceder al portal o al SDK:

1. Verificar VPN/red corporativa (si aplica).
2. Verificar usuario/permisos del integrador.
3. Reportar al equipo de soporte con:

• URL intentada
• fecha/hora
• mensaje de error
• empresa/entorno afectado