WS Emision Servicio CFDI 4.0

CFDI Manager Emisión Cloud 4.
0
Manual de integración
CFDI Manager Emisión Cloud 4.0
Conector Web Service
Revisión 0
Contenido
Descripción de los Servicios web 3
Protocolo seguro 4
Funciones del Web Service 5
Prueba 6
ComprobanteGenerar40 7
ComprobanteBuscar40 9
ComprobanteBuscarUUID40 11
Comprobante_BuscarPdf40 12
ComprobanteCancelar40 13
Comprobante_CancelarUUID40 14
ConsultafacturaId40 15
Control de cambios 16
2
Revisión 0
Descripción de los Servicios web
El uso de esta interfaz consiste en invocar las funciones del Web Service mediante la siguiente URL.
Dirección del Web Service

https://genera.emisiondetecno.mx/Detecno/WebService_EmisionServicio40/Detecno.svc
WSDL que describe la interfaz pública del Web Service

https://genera.emisiondetecno.mx/Detecno/WebService_EmisionServicio40/Detecno.svc?wsdl
https://genera.emisiondetecno.mx/Detecno/WebService_EmisionServicio40/Detecno.svc?singleWsdl
URL del portal de consulta CFDI Web Manager

https://genera.emisiondetecno.mx/Detecno/Emision_servicio40/asp/Start.aspx
3
Revisión 0
Protocolo seguro
Este Web Service utiliza el protocolo TLS para garantizar el intercambio de datos en un entorno seguro y privado
entre el cliente y el servidor. Dicho protocolo funciona básicamente encriptando la información compartida.
Por lo tanto, en el protocolo TLS, se crea un canal seguro y cifrado entre cliente y servidor.
Para invocar este tipo de Web Service es necesario agregar a su aplicación el contexto de seguridad en el
módulo/clase donde se realizará el llamado al WS.
Ejemplo de la declaración del contexto de seguridad en .NET:

ServicePointManager.Expect100Continue = true;
ServicePointManager.SecurityProtocol = SecurityProtocolType.Ssl3 | SecurityProtocolType.Tls;
ServicePointManager.CertificatePolicy = new AcceptAllCertificatePolicy();
4
Revisión 0
Funciones del Web Service
Las funciones disponibles son las siguientes:
● Prueba
● ComprobanteGenerar40
● ComprobanteBuscar40
● ComprobanteBuscarUUID40
● Comprobante_BuscarPdf40
● ComprobanteCancelar40
● Comprobante_CancelarUUID40
● ConsultafacturaId40
A continuación se describen cada una de las funciones disponibles.
5
Revisión 0
Prueba
Función de prueba para comprobar la comunicación con el Web Service.
Valores de Entrada Uso Descripción

valor Requerido Texto libre a enviar al Web Service
Valores de Salida Descripción

PruebaResult Texto libre enviado al web service delimitado por corchetes y anteponiendo
la palabra “Bienvenido”
Ejemplos de mensajes Soap:

Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
<soapenv:Header/>
<soapenv:Body>
<tem:Prueba>
<tem:valor>Detecno</tem:valor>
</tem:Prueba>
</soapenv:Body>
</soapenv:Envelope>
Response
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<PruebaResponse xmlns="http://tempuri.org/">
<PruebaResult>Bienvenido [Detecno]</PruebaResult>
</PruebaResponse>
</s:Body>
</s:Envelope>
6
Revisión 0
ComprobanteGenerar40
Recibe el XML con la información para generar el comprobante fiscal digital. Esta función requiere que
posteriormente a su ejecución se invoque una segunda función llamada ComprobanteBuscar40 para solicitar el
resultado del proceso de sellado-timbrado, obteniendo el XML timbrado.

licencia Requerido Licencia proporcionada por Detecno correspondiente al RFC del Emisor del
comprobante fiscal digital.
cerBytes Opcional Certificado de Sello Digital del emisor, expresado en base64.
Se vuelve opcional cuando el emisor precarga el CSD en la aplicación CFDI
Web Manager.
keyBytes Opcional Llave privada del Certificado de Sello Digital, expresada en base64.
Web Manager.
passBytes Opcional Contraseña del Certificado de Sello Digital, expresada en base64.
Web Manager.
xml Requerido XML con información para generar el comprobante fiscal digital, con
estructura estándar de Detecno. Este XML debe expresarse en
representación de base64.
Valores para pruebas

Para realizar pruebas debe utilizarse la siguiente licencia:
i4ZoYqvJcyY4eytPFPZjzc8Bt5jOWKL-kOoe7AN8H7c=
Para realizar pruebas, el XML debe utilizar el RFC Emisor:

XIA190128J61
Para la estructura del XML ver los archivos:

Ejemplo XML CFDI 4.0.xml
Diccionario CFDI 4.0.xlsx
Valores de Salida en caso de éxito Descripción

Validate Valor “true” que indica que el XML fue recibido exitosamente.
FacturaId Identificador único del comprobante dentro de CFDI Emisión Servicio Cloud
CreditoActual Número del último crédito consumido.
CreditoDisponible Cantidad de créditos restantes a consumir.
CreditoFinal Número del crédito final que se puede consumir.
Podría recibir otros parámetros adicionales que forman parte de la respuesta pero que en caso de éxito estarían vacíos.
7
Revisión 0
Valores de Salida en caso de rechazo Descripción

Validate Valor “false” que indica un error en la estructura del XML.
ErrorMessage Mensaje con el motivo del rechazo.
Podría recibir otros parámetros adicionales que forman parte de la respuesta, pero que en caso de rechazo estarían vacíos.

● Request Ver archivo ComprobanteGenerar40_Request.xml
● Response con éxito Ver archivo ComprobanteGenerar40_Response_Exito.xml
● Response con rechazo Ver archivo ComprobanteGenerar40_Response_Rechazo.xml
8
Revisión 0
ComprobanteBuscar40
Solicita ID de la transacción realizada con ComprobanteGenerar40 y obtiene el resultado de procesar el


facturaId Requerido Identificador del comprobante a buscar, obtenido de la respuesta de la
función “ComprobanteGenerar40”.

CadenaOriginal Cadena original del comprobante.
DomicilioFiscalReceptor Código postal del domicilio fiscal del receptor del comprobante.
ErrorDesc Mensaje en caso de error.
ErrorMessage Mensaje para identificar el módulo en caso de error.
EstatusId Estatus del comprobante (De acuerdo al catálogo de estatus).
Exportacion Código que expresa si el comprobante ampara una operación de
exportación.
FacAtrAdquirente Número de operación proporcionado por el SAT cuando se trate de un
comprobante a través de un PCECFDI o un PCGCFDISP.
FacturaIdOriginal Identificador único que ya tenía el comprobante dentro de CFDI Emisión
Servicio Cloud, asignado en un intento anterior de emitir el comprobante.
Folio Folio interno del comprobante.
Qr Cadena alfanumérica del código de barras bidimensional.
RechazoId Código de rechazo (De acuerdo al catálogo de rechazos).
RegimenFiscalReceptor Clave del régimen fiscal del contribuyente receptor al que aplicará el efecto
fiscal de este comprobante.
RfcEmisor RFC del emisor del comprobante.
RfcReceptor RFC del receptor del comprobante.
Sello Sello del comprobante.
Serie Serie interna del comprobante.
Total1 Total del comprobante.
Uuid Folio fiscal del SAT.
UuidOriginal Folio fiscal del SAT, que se asignó en un intento anterior de emitir el
comprobante.
Validate Valor “true” o “false” que indica el resultado de la búsqueda del CFDI.
Version Versión del comprobante.
Xml XML final sellado y timbrado.
XmlAcuseCancelacionCfdi Acuse XML del proceso de cancelación del CFDI.
9
Revisión 0

● Request Ver archivo ComprobanteBuscar40_Request.xml
● Response – Comprobante Emitido Ver archivo ComprobanteBuscar40_Response_Emitido.xml
● Response – Comprobante Rechazado Ver archivo ComprobanteBuscar40_Response_Rechazado.xml
● Response – Comprobante Timbre previo Ver archivo ComprobanteBuscar40_Response_Timbre_previo.xml
● Response – Comprobante Cancelado Ver archivo ComprobanteBuscar40_Response_Cancelado.xml
10
Revisión 0
ComprobanteBuscarUUID40
Solicita el UUID de la factura timbrada anteriormente, y obtiene el XML timbrado y datos clave de la factura.

uuid Requerido Folio fiscal del SAT del comprobante a buscar.

CadenaOriginal Cadena original del comprobante.
DomicilioFiscalReceptor Código postal del domicilio fiscal del receptor del comprobante.
ErrorDesc Mensaje en caso de error.
ErrorMessage Mensaje para identificar el módulo en caso de error.
EstatusId Estatus del comprobante (De acuerdo al catálogo de estatus).
Exportacion Código que expresa si el comprobante ampara una operación de exportación.
FacAtrAdquirente Número de operación proporcionado por el SAT cuando se trate de un
comprobante a través de un PCECFDI o un PCGCFDISP.
FacturaIdOriginal Identificador único que ya tenía el comprobante dentro de CFDI Emisión
Servicio Cloud, asignado en un intento anterior de emitir el comprobante.
Folio Folio interno del comprobante.
Qr Cadena alfanumérica del código de barras bidimensional.
RechazoId Código de rechazo (De acuerdo al catálogo de rechazos).
RegimenFiscalReceptor Clave del régimen fiscal del contribuyente receptor al que aplicará el efecto
fiscal de este comprobante.
RfcEmisor RFC del emisor del comprobante.
RfcReceptor RFC del receptor del comprobante.
Sello Sello del comprobante.
Serie Serie interna del comprobante.
Total1 Total del comprobante.
Uuid Folio fiscal del SAT.
UuidOriginal Folio fiscal del SAT, que se asignó en un intento anterior de emitir el
comprobante.
Validate Valor “true” o “false” que indica el resultado de la búsqueda del CFDI.
Version Versión del comprobante.
Xml XML final sellado y timbrado.
XmlAcuseCancelacionCfdi Acuse XML del proceso de cancelación del CFDI.

● Request Ver archivo ComprobanteBuscarUUID40_Request.xml
● Response con éxito Ver archivo ComprobanteBuscarUUID40_Response_Exito.xml
● Response con rechazo Ver archivo ComprobanteBuscarUUID40_Response_Rechazo.xml
11
Revisión 0
Comprobante_BuscarPdf40
Solicita ID de la transacción realizada con ComprobanteGenerar40 y obtiene el PDF del comprobante fiscal
digital resultante.


Validate Valor “true” que indica el resultado exitoso de la búsqueda del PDF.
Pdf64 Cadena en Base 64 de la representación en PDF del comprobante. Este
parámetro se muestra en caso de que la transacción sea correcta.
Podría recibir otros parámetros adicionales que forman parte de la respuesta, pero que en caso de éxito estarían vacíos.
Valores de Salida en caso de rechazo Descripción

Validate Valor “false” que indica el resultado fallido de la búsqueda del PDF.
FacturaId Identificador único del comprobante dentro de CFDI Emisión Servicio
Cloud
ErrorMessage Mensaje corto que muestra el error.
ErrorDesc Descripción detallada del motivo del error.

● Request Ver archivo Comprobante_BuscarPdf40_Request.xml
● Response con éxito Ver archivo Comprobante_BuscarPdf40_Response_Exito.xml
● Response con rechazo Ver archivo Comprobante_BuscarPdf40_Response_Rechazo.xml
12
Revisión 0
ComprobanteCancelar40
Solicita ID de la transacción realizada con ComprobanteGenerar40 y envía el comprobante al proceso de

cancelación de CFDI’s.

MotivoCancelacion Requerido Motivo de cancelación del comprobante:
"01" Comprobantes emitidos con errores con relación.
"02" Comprobantes emitidos con errores sin relación.
"03" No se llevó a cabo la operación.
"04" Operación nominativa relacionada en una factura global.
FolioSustitucion Opcional UUID que sustituye al folio fiscal cancelado. Es requerido cuando la clave
del motivo de cancelación es 01.

Validate Valor “true” que indica que la solicitud de cancelación se recibió con éxito.
Valores de Salida en caso de Descripción

rechazo
Validate Valor “false” que indica que la solicitud de cancelación no pudo ser recibida

● Request Ver archivo ComprobanteCancelar40_Request.xml
● Response con éxito Ver archivo ComprobanteCancelar40_Response_Exito.xml
● Response con rechazo Ver archivo ComprobanteCancelar40_Response_Rechazo.xml
13
Revisión 0
Comprobante_CancelarUUID40
Solicita el UUID del comprobante y lo envía al proceso de cancelación de CFDI’s.

UUID Requerido Folio fiscal del SAT del comprobante a cancelar.
MotivoCancelacion Requerido Motivo de cancelación del comprobante:
"01" Comprobantes emitidos con errores con relación.
"02" Comprobantes emitidos con errores sin relación.
"03" No se llevó a cabo la operación.
"04" Operación nominativa relacionada en una factura global.
FolioSustitucion Opcional UUID que sustituye al folio fiscal cancelado. Es requerido cuando la clave
del motivo de cancelación es 01.

Validate Valor “true” que indica que la solicitud de cancelación se recibió con éxito.
UUID Folio fiscal del SAT del comprobante que se envió a cancelar.

rechazo
Validate Valor “false” que indica que la solicitud de cancelación no pudo ser recibida
UUID Folio fiscal del SAT del comprobante que se envió a cancelar.

● Request Ver archivo Comprobante_CancelarUUID40_Request.xml
● Response con éxito Ver archivo Comprobante_CancelarUUID40_Response_Exito.xml
● Response con rechazo Ver archivo Comprobante_CancelarUUID40_Response_Rechazo.xml
14
Revisión 0
ConsultafacturaId40
Solicita la serie, el folio, el RFC emisor y la fecha original de la transacción realizada con ComprobanteGenerar40
y obtiene el facturaId asignado por el sistema.

Serie Requerido Serie interna del comprobante.
Folio Requerido Folio interno del comprobante.
RfcEmisor Requerido RFC del emisor del comprobante.
FechaSolicitud Requerido Fecha original de envío de la factura.

Validate Valor “true” que indica que la consulta se realizó con éxito.
FacturaId Regresa uno o varios elementos <string> cada uno con el valor del facturaId
encontrado de acuerdo a los criterios de búsqueda.

rechazo
Validate Valor “false” que indica que la consulta no pudo ser realizada..

● Request Ver archivo ConsultafacturaId40_Request.xml
● Response con éxito Ver archivo ConsultafacturaId40_Response_Exito.xml
● Response con rechazo Ver archivo ConsultafacturaId40_Response_Rechazo.xml
15
Revisión 0
Control de cambios
Revisión Fecha Elaboró Descripción de las modificaciones

0 22/jul/2022 Christian Montoya Elaboración del documento.
16

WS Emision Servicio CFDI 4.0

Cargado por

Información del documento

Descripción original:

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

WS Emision Servicio CFDI 4.0

Cargado por

Copyright:

Formatos disponibles

CFDI Manager Emisión Cloud 4.

Descripción de los Servicios web 3

Funciones del Web Service 5

Descripción de los Servicios web

Dirección del Web Service

WSDL que describe la interfaz pública del Web Service

URL del portal de consulta CFDI Web Manager

Ejemplo de la declaración del contexto de seguridad en .NET:

Funciones del Web Service

Las funciones disponibles son las siguientes:

A continuación se describen cada una de las funciones disponibles.

Función de prueba para comprobar la comunicación con el Web Service.

Valores de Entrada Uso Descripción

Valores de Salida Descripción

Ejemplos de mensajes Soap:

Valores de Entrada Uso Descripción

Valores para pruebas

Para realizar pruebas, el XML debe utilizar el RFC Emisor:

Para la estructura del XML ver los archivos:

Valores de Salida en caso de éxito Descripción

Valores de Salida en caso de rechazo Descripción

Ejemplos de mensajes Soap:

Solicita ID de la transacción realizada con ComprobanteGenerar40 y obtiene el resultado de procesar el

Valores de Entrada Uso Descripción

Valores de Salida Descripción

Ejemplos de mensajes Soap:

Valores de Entrada Uso Descripción

Valores de Salida Descripción

Ejemplos de mensajes Soap:

Valores de Entrada Uso Descripción

Valores de Salida en caso de éxito Descripción

Valores de Salida en caso de rechazo Descripción

Ejemplos de mensajes Soap:

Solicita ID de la transacción realizada con ComprobanteGenerar40 y envía el comprobante al proceso de

Valores de Entrada Uso Descripción

Valores de Salida en caso de éxito Descripción

Valores de Salida en caso de Descripción

Ejemplos de mensajes Soap:

Solicita el UUID del comprobante y lo envía al proceso de cancelación de CFDI’s.

Valores de Entrada Uso Descripción

Valores de Salida en caso de éxito Descripción

Valores de Salida en caso de Descripción

Ejemplos de mensajes Soap:

Valores de Entrada Uso Descripción

Valores de Salida en caso de éxito Descripción

Valores de Salida en caso de Descripción

Ejemplos de mensajes Soap:

Revisión Fecha Elaboró Descripción de las modificaciones

También podría gustarte