Guía para consultores, desarrolladores e integradores NetSuite que necesitan conectar una cuenta NetSuite con MYSuite (PAC autorizado por el SAT, autorización 55270), para la certificación de CFDI.
Es la modalidad de integración de mayor cobertura funcional y la base histórica del esquema de MYSuite. Está pensada para empresas que operan un ERP como NetSuite y requieren interacción sistema a sistema para el ciclo completo del comprobante: generación, sellado con el CSD del emisor, certificación, entrega del CFDI y la representación gráfica (PDF), distribución por correo al receptor, consulta, validación, recepción y cancelación.
El cliente no construye el CFDI conforme al Anexo 20; construye un XML Nativo de MYSuite —un formato propio, más simple y estable que el Anexo 20— y MYSuite se encarga de convertirlo en CFDI, firmarlo y certificarlo. Este desacoplamiento es la ventaja estructural del servicio: los cambios de versión que publica el SAT (CFDI 4.0, Retenciones 2.0, Pagos 2.0, Carta Porte 3.1, etc.) se absorben en la plataforma y no obligan a reescribir el generador del ERP. La modalidad admite además la totalidad de complementos fiscales vigentes y el catálogo de addendas comerciales de MYSuite.
La capa de servicio es un Web Service SOAP que responde de forma síncrona: se recibe una transacción, MYSuite ejecuta la acción y devuelve la respuesta en la misma llamada.
https://www.mysuitetest.com/mx.com.fact.wsfront/FactWSFront.asmxhttps://www.mysuitecfdi.com/mx.com.fact.wsfront/FactWSFront.asmxTodas las transacciones de esta modalidad se invocan a través de una única operación, RequestTransaction, con el mismo sobre. El nombre de la transacción viaja como cadena en el nodo <Transaction> y las cargas útiles en <Data1>, <Data2> y <Data3>.
CONVERT_NATIVE_XML).MX".JES900109Q90.Requestor.País.Entity.Usuario_NetSuite (por ejemplo MX.JES900109Q90.Jacinto). Esto permite trazabilidad por emisor, sucursal, departamento o empleado.<Result> dentro de <Response>.true, la transacción se completó y deben recogerse los datos devueltos.false, deben mostrarse al operador los nodos <Description>, <Hint> y <Data>, que contienen la información necesaria para corregir el problema.Data1 excede 1 MB, MYSuite responde false: ese comprobante debe procesarse por el Servicio Grandes Asíncrono.LOOKUP_ISSUED_INTERNAL_ID es el mecanismo estándar de control de no duplicidad: consulta cuántos comprobantes existen en MYSuite con el número interno del ERP. Debe implementarse como paso previo o de reconciliación ante reintentos y pérdidas de respuesta.Es la modalidad con integración nativa en NetSuite a través de la configuración de PAC para México, en la que se registran el ID Fiscal (RFC), la URL del Web Service y el Requestor como Nombre de Usuario:
Emisión
Consulta y Recuperación
Validación y Recepción
CFDI de Retenciones
Esquema de cancelación
Servidor dedicado y modelo asíncrono para procesar archivos XML Nativos de MYSuite grandes (Data1 > 1 MB, hasta 70 MB en producción).
Es un servicio dedicado a la emisión/certificación de comprobantes de gran tamaño, operado bajo un modelo asíncrono de cinco etapas: solicitud, encolamiento, procesamiento, consulta de resultado y obtención de enlaces de descarga de archivos del cfdi (xml y pdf). No sustituye al servicio síncrono, lo complementa: cada servicio atiende un rango de tamaño distinto y ambos rechazan el tráfico que corresponde al otro.
Su valor para una integración NetSuite es doble.
Se mantiene el mismo sobre RequestTransaction y el mismo juego de credenciales que en la modalidad síncrona, pero sobre hosts propios:
https://async.mysuitetest.com/factwsfront.asmxhttps://async.mysuitecfdi.com/factwsfront.asmxEl ciclo se compone de tres transacciones que deben implementarse en secuencia:
Encola la solicitud de generación. EnData1va el XML Nativo de MYSuite en Base64. EnData2va, en texto plano, un identificador único de la transacción del lado del cliente (Id, GUID o cualquier valor único en su ERP); es obligatorio, con máximo de 50 caracteres, y es el mecanismo que impide información repetida en MYSuite. ConResultigual atrue, la respuesta llega enResponseData1como una cadena en formato GUID: el identificador de la solicitud, indispensable para toda operación posterior.
Consulta el estado de la solicitud. EnData1se envía el identificador obtenido en el paso anterior. La respuesta llega simultáneamente enResponseData1(XML) yResponseData2(JSON), ambos en Base64 y con el mismo contenido, para que el integrador use el formato que le resulte más cómodo. Campos devueltos:Entity,Uuid,InternalID,EnrolledTimeStamp,Status,DocumentGUID,Year,Batch,SerialyErrorMsg. ElStatusadmite tres valores: 1 pendiente de procesar, 2 procesado con éxito, 3 procesado con error. Los camposDocumentGUID,Year,BatchySerialsólo tienen valor cuandoStatus= 2;ErrorMsgsólo cuandoStatus= 3, devuelto en Base64. ConStatus= 3 se entrega además un log enResponseData3, en Base64, con el motivo por el que no pudo emitirse.
Recupera el documento generado. EnData1se envía el identificador de la solicitud. La respuesta es equivalente a la deRETRIEVE_DOCUMENTcon dos diferencias sustantivas: siempre devuelve XML y PDF (no hay parámetro de selección), y lo que llega enResponseData1yResponseData3no es el contenido del archivo sino el enlace al archivo en la nube, igualmente codificado en Base64.
Data1 información superior a 1 MB, con límite máximo de 70 MB. El tiempo de generación del CFDI depende de la carga de solicitudes asíncronas que se tengan encoladas en este servicio y del tamaño del xml nativo enviado.Data1 con tamaño mayor a 1 MB y hasta 2 MB. Este punto debe considerarse al planear las pruebas, porque no permite validar los tamaños reales de producción.Data1 es menor a 1 MB, el servicio responde false: ese archivo debe ir por el servicio síncrono.ASYNC_RETRIEVE_DOCUMENT genera enlaces nuevos con vigencia de 5 días.Result igual a false, indicando en <Data> que el número interno ya existe. Aun así, ResponseData1 devuelve el identificador de la solicitud existente, como si se hubiera registrado en ese momento. Esto permite implementar reintentos idempotentes sin generar comprobantes duplicados: ante un 3196, el ERP debe tomar el identificador devuelto y continuar el flujo con ASYNC_CONVERT_VERIFY.El patrón natural en NetSuite es separar el ciclo en dos ejecuciones: un script que encola (disparado por evento de usuario o por proceso programado) y un script programado o Map/Reduce que verifica el estado y recupera los documentos. Dado que ASYNC_RETRIEVE_DOCUMENT devuelve enlaces y no contenido, la descarga debe realizarse en un paso adicional y el archivo persistirse en el File Cabinet antes de que expire la vigencia de 5 días. El identificador de solicitud (GUID) y el número interno enviado en Data2 deben almacenarse en campos personalizados del registro de transacción de NetSuite: son la única llave de correlación entre el ERP y la cola de MYSuite.
Procesa XML o JSON nativo de MYSuite sobre REST. Recomendado cuando el equipo NetSuite prefiere REST ya sea con JsonServiceCall o RequestTransaction.
Ofrece la misma cobertura funcional que CFDI + Timbrado (SOAP) —emisión, validación, certificación, consulta, recepción, retenciones y cancelación 2022 sobre CFDI v4.0 y todos los complementos fiscales vigentes— pero sobre un transporte API REST. Está dirigida a equipos que prefieren consumir servicios HTTP con cargas JSON y evitar la construcción de sobres SOAP.
Su particularidad de diseño es que expone dos recursos alternativos con semánticas distintas, y la elección entre ellos condiciona el desarrollo completo:
Requestor, Transaction, Country, Entity, User, UserName, Data1, Data2, Data3) y se autentica con el Requestor en cada llamada, sin token. Es la vía de menor esfuerzo para migrar una integración SOAP existente a REST, porque la lógica de armado de Data1/Data2 se conserva íntegra.jsonData (la carga útil, en Base64), transactionName (el nombre de la transacción) y token (credencial de sesión). Requiere autenticación previa por token.https://api.mysuitetest.com/https://api.mysuitecfdi.com/Los recursos se invocan por ruta, por ejemplo https://api.mysuitetest.com/RequestTransaction, https://api.mysuitetest.com/JsonServiceCall
https://api.mysuitetest.com/swagger/ui/index#/.
https://api.mysuitetest.com/swagger/docs/v1 (con esquema HTTPS) para que cargue correctamente.El documento de entrada sigue siendo el XML Nativo de MYSuite versión 8 (fx_2010_g.xsd) o su equivalente en JSON nativo, y la transacción de emisión sigue siendo CONVERT_NATIVE_XML, MYSuite lo convierte en CFDI, lo firma con el CSD del emisor y lo timbra/certifica.
Autenticación por token (ruta JsonServiceCall). Antes de cualquier solicitud debe obtenerse un token mediante AUTHENTICATE, enviando taxID (RFC del emisor), user y pass (usuario y contraseña proporcionados por MYSuite para ese RFC). La respuesta devuelve result, payload, token, errorMsg y errorCode.

errorCode 101 indica que la vida del token expiró y debe volverse a autenticar; errorCode 102 indica token inválido (falla al desencriptar y parsear la información de autenticación de la llamada).Es la modalidad más directa de consumir desde SuiteScript, porque se resuelve con peticiones HTTP y manejo de objetos JSON, sin necesidad de construir y parsear XML de sobre.
RequestTransaction minimiza el cambio.JsonServiceCall, debe diseñarse desde el inicio la gestión de estado del token: al ser rotativo y con expiración, un script Map/Reduce con múltiples ejecuciones concurrentes debe centralizar la custodia del token o autenticarse por ejecución, para evitar invalidaciones cruzadas.Vía RequestTransaction
Emisión de CFDI a partir de JSON nativo, invocada mediante JsonServiceCall y con método AUTHENTICATE.
Es la modalidad que emite/certifica un CFDI (conforme al Anexo 20 vigente), a partir de un archivo JSON nativo de MYSuite. Está dirigida a equipos cuyo flujo de datos es JSON de extremo a extremo y que prefieren no generar ni manipular XML en el ERP.
Su diferencia arquitectónica frente a API REST es importante y suele ser fuente de confusión.
EndPoint no es un servicio REST.FactWSFront, pero a través de dos operaciones distintas de las usadas por CFDI + Timbrado: Authenticate y JSONServiceCall.El servicio contempla la construcción del JSON tanto para CFDI simples como para casos con complementos fiscales y con addendas comerciales, que se identifican a nivel de la estructura principal del archivo JSON.
https://www.mysuitetest.com/mx.com.fact.wsfront/factwsfront.asmxhttps://www.mysuitecfdi.com/mx.com.fact.wsfront/factwsfront.asmxAutenticación.
Authenticate con taxID (RFC del emisor), user y pass.<AuthenticateResult> como un objeto JSON con los campos Result, Payload, ErrorMsg, ErrorCode y Token.Invocación de transacciones.
JSONServiceCall, que recibe tres elementos: jsonData (la carga útil en JSON), transactionName (nombre de la transacción) y token.<JsonServiceCallResult> como objeto JSON con Result, Payload, ErrorMsg, ErrorCode y Token; el resultado de la transacción se entrega en Payload en Base64.Transacciones de emisión y consulta.
CONVERT_NATIVE_XML4 devuelve, en Base64, el XML y el PDF del CFDI generado a partir del JSON enviado.CONVERT_NATIVE_XML_BASIC4 devuelve únicamente los metadatos del comprobante generado, sin los archivos: es la opción indicada cuando el ERP no necesita el XML ni el PDF en la misma llamada, y reduce de forma significativa el volumen de la respuesta.CONVERT_NATIVE_XML_SN4 devuelve, en Base64, XML del CFDI sin NATIVO de MYSuite y PDF del CFDI.LOOKUP_ISSUED_INTERNAL_ID está destinada al control de la no duplicidad: uno de sus parámetros es el número interno que corresponde a un único identificador de transacción, llamada, operación o registro en el ERP del cliente.RETRIEVE_DOCUMENT permite obtener el XML y el PDF de un CFDI ya emitido en cualquier momento posterior. El desarrollo combina dos habilidades: armado de sobre SOAP y manejo de JSON. En SuiteScript esto se traduce en construir el envelope, insertar el JSON como contenido de texto —con el escape correcto de caracteres— y parsear la respuesta en dos niveles: primero el XML del sobre para extraer JsonServiceCallResult, y después el JSON contenido en ese nodo. Debe tenerse presente que la codificación de jsonData no es uniforme entre transacciones ni entre modalidades: en la cancelación por EndPoint se documenta el JSON en texto plano, mientras que la carga equivalente por API REST se documenta en Base64, y dentro de EndPoint el campo XmlSel de la consulta sí va en Base64.
Servicio | Protocolo | Documento de entrada | Autenticación | Modelo | Tamaño de Data1 | |
| CFDI + Timbrado (SOAP) | SOAP / XML | XML Nativo MYSuite v8 | Requestor (GUID) en cada llamada | Síncrono | Hasta 1 MB | |
| CFDI + Timbrado (SOAP) — Grandes Asíncrono | SOAP / XML | XML Nativo MYSuite v8 | Requestor (GUID) en cada llamada | Asíncrono (encolado + consulta) | > 1 MB y hasta 70 MB (productivo) | |
| CFDI + Timbrado (API REST) | REST / JSON | XML Nativo MYSuite v8 o JSON Nativo MYSuite | Requestor (GUID) o token con expiración | Síncrono | Hasta 1 MB | |
| EndPoint |
| JSON Nativo MYSuite | Token con expiración (rotativo) | Síncrono | Hasta 1 MB |

La decisión debe tomarse sobre cuatro variables: tamaño del comprobante, formato de trabajo del equipo, existencia de una integración previa y perfil del proyecto.
Data1 y decide el destino, dado que cada servicio rechaza el tráfico del otro.JsonServiceCall.RequestTransaction: conserva el contrato de campos y la lógica de Data1/Data2.LOOKUP_ISSUED_INTERNAL_ID; en Grandes Asíncrono, mediante el número interno obligatorio en Data2.JES900109Q90 y la Sucursal asignada antes de habilitar producción.