Facilweb
Wiki Facilweb Base documental interna

Wiki Facilweb / Soporte tecnico / Facturacion electronica

Diagnostico de Problemas de Facturacion Electronica

Articulo operativo para revisar casos de facturacion electronica antes del escalamiento. Incluye pasos, comandos utiles, ejemplos visuales y formato de reporte.

Resumen

Este tema ayuda a que el equipo diagnostique con evidencia y orden. No reemplaza la wiki completa: es uno de los procedimientos que viviran dentro de ella.

Regla de oro: antes de escalar un caso, el tecnico debe revisar el procedimiento, tomar evidencia y dejar una conclusion preliminar documentada.

Procedimiento

Paso 1. Identificar el software

Confirmar si el caso ocurre en FACILWEB NUBE, FACILWEB ESCRITORIO o FACILWEB FE antes de tocar configuraciones o escalar.

FACILWEB NUBE FACILWEB ESCRITORIO FACILWEB FE

Paso 2. Identificar el documento afectado

Definir exactamente que documento esta fallando y si el problema ocurre con un documento puntual o con todos.

Factura electronica Nota credito Nota debito Documento soporte Evento RADIAN Otro documento

Paso 3. Solicitar acceso remoto al cliente

Validar el procedimiento real del usuario antes de asumir que el sistema esta fallando.

Que opcion esta usando Empresa correcta Usuario correcto Pestanas abiertas Si cambio el encargado Si esta ejecutando bien el proceso

Paso 4. Leer el error completo

Guardar evidencia precisa del problema y no interpretar mensajes a medias.

Captura de pantalla Texto exacto del error Hora del error Accion ejecutada Documento que intento enviar

Paso 5. Verificar configuracion

Revisar si el inconveniente nace en folios, certificado, resolucion, plan o parametros internos.

Resolucion DIAN Vigencia Prefijo y consecutivo Folios disponibles Plan renovado Certificado digital Empresa y NIT correctos

Paso 6. Validar el API

Abrir el dominio o endpoint correspondiente y comprobar que el servicio responda correctamente.

Que el dominio abra Que el endpoint responda Sin error 500 Sin error SSL HTTP 200 cuando aplique

Paso 7. Revisar Request y Response

Nunca diagnosticar sin revisar tanto la salida del sistema como la respuesta del servidor o de la DIAN.

JSON enviado NIT, prefijo, consecutivo Totales, impuestos, productos Codigo HTTP Mensaje del API Mensaje de la DIAN Errores de autenticacion o certificado

Paso 8. Revisar logs

Cruzar hora exacta del error con logs de aplicacion, API y servidor.

Log de FACILWEB Log del API Log del servidor Time-outs Errores 500 Errores de permisos Errores de conexion

Paso 9. Diagnostico de conectividad del cliente

Comprobar DNS, HTTPS, puertos y ruta desde el equipo del cliente hacia nuestros endpoints.

nslookup ping tracert pathping curl -I Test-NetConnection 443 Test-NetConnection 80 ipconfig /flushdns ipconfig /all

Paso 10. Revisar antivirus y firewall

Confirmar si un antivirus, firewall, VPN o cambio de red empezo a bloquear la comunicacion con el API.

Antivirus reciente Firewall nuevo Cambio de ISP VPN activa Bloqueo del dominio Bloqueo del ejecutable o navegador

Paso 11. Revisar enrutamiento

Aunque haya internet, puede no existir ruta funcional hacia nuestros servidores o endpoints.

tracert dominio.com pathping dominio.com Test-NetConnection dominio.com -Port 443

Paso 12. Validar si el problema es general

Antes de cerrar diagnostico, confirmar si el fallo afecta a mas clientes, documentos o servicios externos.

Otros clientes Otros documentos Estado de la DIAN Latencia del API Cambios recientes

Paso 13. Documentar el caso

Todo caso debe quedar listo para conocimiento interno y seguimiento tecnico posterior.

Empresa NIT Persona que reporta Fecha y hora Capturas Request Response Logs Pruebas realizadas Conclusion preliminar

Paso 14. Escalar solo si no se soluciono

Gerencia debe recibir un caso completo, con evidencia, pruebas y conclusion tecnica preliminar.

Empresa y NIT Cliente y usuario afectado Documento afectado Capturas Error completo Request y Response Logs Resultado de las pruebas

Comandos utiles

Estos bloques estan presentados como fichas de referencia rapida, para que el personal los identifique facilmente dentro del articulo.

DNS
Diagnostico DNS Referencia rapida 
nslookup api.midominio.com
ping api.midominio.com
ipconfig /flushdns
WEB
Conectividad HTTPS Referencia rapida 
curl -I https://api.midominio.com
curl -I https://api.midominio.com/facturacion
Test-NetConnection api.midominio.com -Port 443
NET
Ruta y perdida de paquetes Referencia rapida 
tracert api.midominio.com
pathping api.midominio.com

Ejemplos visuales

En lugar de llenar la wiki con solo texto, este articulo incluye ejemplos tipo captura para mostrarle al personal como se verian pruebas o evidencias dentro del proceso.

Consola de ejemplo

Ejemplo de validacion DNS

C:\> nslookup api.midominio.com Address: 8.8.8.8 Non-authoritative answer: Name: api.midominio.com Address: 179.1.64.103
Navegador de ejemplo

Ejemplo de respuesta HTTPS

$ curl -I https://api.midominio.com HTTP/1.1 200 OK content-type: application/json server: nginx
Registro visual

Ejemplo de evidencia de error

Mensaje capturado: "Error de autenticacion del certificado" Hora: 10:43 AM Documento: Factura FE-10328
Formulario de ejemplo

Ejemplo de reporte interno

Formato de reporte

EMPRESA Completar con evidencia verificable.
NIT Completar con evidencia verificable.
PERSONA QUE REPORTA Completar con evidencia verificable.
USUARIO AFECTADO Completar con evidencia verificable.
SOFTWARE Completar con evidencia verificable.
DOCUMENTO AFECTADO Completar con evidencia verificable.
FECHA Completar con evidencia verificable.
HORA Completar con evidencia verificable.
ERROR REPORTADO Completar con evidencia verificable.
CAPTURAS Completar con evidencia verificable.
REQUEST Completar con evidencia verificable.
RESPONSE Completar con evidencia verificable.
PRUEBAS REALIZADAS Completar con evidencia verificable.
RESULTADO DE LAS PRUEBAS Completar con evidencia verificable.
CONCLUSION PRELIMINAR DEL TECNICO Completar con evidencia verificable.