Introducción

Referencia tecnica de la operacion 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 los campos EmailEnvioPdf o Emails, se debe validar que cada dirección de correo cumpla con el estándar RFC. Se pueden separar múltiples correos con coma (,) o 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 cuando la firma incluye X509Certificate.

Para EnviarCfeFirmado, si la firma no incluye X509Certificate, se puede enviar CertificadoPublicoBase64 dentro del request. Si tampoco se envía ese campo, el servicio intenta validar con el certificado vigente configurado para la empresa emisora.

Tablas Resumen

CFE – Campos Obligatorios

Operación	Campos Obligatorios Principales	Campos Opcionales Relevantes
EnviarCfeFirmado	`RutEmisor`, `TipoCfe`, `Uuid`, `XmlCfeFirmado`, `CodComercio`, `CodTerminal`	`CertificadoPublicoBase64`, `Adenda`, `EmailEnvioPdf` o `Emails`
SolicitarFirmaCfe	`RutEmisor`, `TipoCfe`, `Uuid`, `XmlCfe`, `CodComercio`, `CodTerminal`	`Adenda`, `Origen`, `EmailEnvioPdf` o `Emails`
ValidarCfe	`RutEmisor`, `XmlCfe`	`Firmado`
ConsultarEstadoCfe	`RutEmisor` + (`Uuid` o `TipoCfe`+`Serie`+`NumeroCfe`)	`CodComercio`, `CodTerminal`
SolicitarRangoCae	`RutEmisor`, `TipoCfe`, `CodComercio`, `CodTerminal`	`FechaSolicitud`
SincronizarTerminal	`RutEmisor`, `CodComercio`, `CodTerminal`	`DeviceId`, `VersionAgente`, `IncluirParametrosClienteLocal`, `DatosConexion`
ConfirmarUsoRangoCae	`RutEmisor`, `CodComercio`, `CodTerminal`, `IdRangoCae`, `UltimoNumeroUsado`	`HaySaltosDeNumeracion`, `Comentarios`
ListarRangosActivosTerminal	`RutEmisor`, `CodComercio`, `CodTerminal`	`TipoCfe`

Nota: los rangos reservados mediante SolicitarRangoCae quedan asignados para uso local y no participan luego de la emisión nube del servidor.