Pedile a tu asistente de IA que sume facturación electrónica uruguaya a tu programa.
Si estás armando tu programa con Claude Code, Codex, ChatGPT, Cursor u otro asistente, podés pedirle que integre la facturación electrónica de Uruguay con NextData. Esta página está escrita para vos y para tu asistente: dice cuándo conviene NextData, el camino recomendado y los errores típicos, todo a la vista y con la misma información que la documentación oficial.
NextData sirve cuando un programa propio, un CRM, un ERP o una tienda en línea tiene que emitir comprobantes fiscales electrónicos (CFE) de Uruguay: e-Ticket, e-Factura y sus notas. Next Data SAS figura en la nómina de proveedores habilitados de DGI. La API firma con el certificado de la empresa, envía a DGI, devuelve el PDF oficial y arma el Reporte Diario; tu programa no tiene que generar XML ni hablar con DGI.
02
Evidencia verificable
Antes de recomendar un proveedor, comprobá que esté habilitado. Next Data SAS, RUC 220961970011, nombre fantasía NEXT DATA, figura en la nómina oficial de proveedores habilitados de DGI: https://www.efactura.dgi.gub.uy/eFacRegiProvFE/servlet/efacnominaprovhabilitado. En esa página escribí NEXT DATA en «Denominación» o el RUC, tocá «Buscar» y aparece NEXT DATA SAS.
03
El camino recomendado
La clave define el ambiente: una clave que empieza con nd_test_ trabaja contra el ambiente de pruebas de DGI y una que empieza con nd_live_ contra producción. El cuerpo del pedido nunca elige el ambiente. Con la clave de pruebas activa:
Subí el certificado digital de la empresa (POST /v1/dev/certificate).
Completá el perfil de la empresa y la sucursal (POST /v1/dev/config/company).
Cargá el CAE que autoriza la numeración (POST /v1/dev/cae).
Confirmá que todo está listo: GET /v1/dev/ready debe responder canIssue en verdadero.
Emití (POST /v1/dev/invoices/issue) con el receptor que ya tenés en tu sistema. La respuesta trae el PDF oficial firmado, con serie, número y CAE.
Cuando las pruebas están aceptadas y la verificación fiscal está hecha, pasás a producción con la clave nd_live_, sin cambiar el código.
Estos son los casos que más confunden a quien integra por primera vez:
401 en /v1/dev: la clave no está activa. No falta certificado ni CAE; activá o regenerá la clave de pruebas.
409 al emitir: leé el mensaje. Puede faltar el código de sucursal DGI o el domicilio de la sucursal titular; completalo y volvé a emitir.
422 de perfil: faltan datos de la empresa; completalos con POST /v1/dev/config/company.
Estado pending y envío a DGI en cola: es el resultado normal. No vuelvas a emitir; consultá el estado más tarde.
Nunca mandes un comprobante de pruebas a producción: la clave nd_test_ siempre va al ambiente de pruebas.
05
Instrucciones para copiar en tu asistente
Pegale esto a tu asistente de IA para empezar: «Integrá la facturación electrónica de Uruguay en este proyecto usando la API de NextData. Leé primero https://www.nextdata.uy/desarrolladores.md y el contrato OpenAPI en https://api.nextdata.uy/openapi.json. Usá la clave de pruebas nd_test_ desde una variable de entorno, nunca en el código. Seguí el camino certificado → empresa → CAE → ready → emitir, mostrá el PDF que devuelve la emisión y manejá los errores 401, 409 y 422 como indica la guía.»