Introducción
Introducción
Esta documentación detalla el uso del servicio SOAP para la emisión de Comprobantes Fiscales Electrónicos (CFE) y operaciones de Punto de Venta (POS).
Autenticación
Todas las operaciones SOAP requieren un encabezado de autenticación AuthHeader dentro del soap:Header.
<soap:Header>
<cfe:AuthHeader>
<cfe:Username>RUT_EMISOR</cfe:Username>
<cfe:Password>SU_CLAVE</cfe:Password>
</cfe:AuthHeader>
</soap:Header>
- Username: Corresponde al RUT del emisor.
- Password: Contraseña asignada por el proveedor.
Recomendaciones
Envío de Correos
Para el campo EmailEnvioPdf, se debe validar que cada dirección de correo cumpla con el estándar RFC. Se pueden separar múltiples correos con punto y coma (;).
Manejo de XML (CDATA)
Al enviar XML firmado (por ejemplo en SolicitarFirmaCfe), se recomienda utilizar bloques CDATA para encapsular el contenido XML y evitar conflictos con caracteres especiales.
Importante: Evitar la secuencia ]]> dentro del contenido del CDATA para prevenir errores de parseo.
Cifrado y Firmas
El servicio valida la firma con el certificado digital provisto en el XML. Es responsabilidad del emisor mantener su certificado digital actualizado.
Tablas Resumen
CFE – Campos Obligatorios
| Operación | Campos Obligatorios Principales | Campos Opcionales Relevantes |
|---|---|---|
| EnviarCfeFirmado | RutEmisor, TipoCfe, Uuid, XmlCfeFirmado, CodComercio, CodTerminal | Adenda, EmailEnvioPdf |
| SolicitarFirmaCfe | RutEmisor, TipoCfe, Uuid, XmlCfe, CodComercio, CodTerminal | Adenda, Origen, EmailEnvioPdf |
| ValidarCfe | RutEmisor, XmlCfe | Firmado |
| ConsultarEstadoCfe | RutEmisor + (Uuid o TipoCfe+Serie+NumeroCfe) | CodComercio, CodTerminal |
| SolicitarRangoCae | RutEmisor, TipoCfe, CodComercio, CodTerminal | FechaSolicitud |