Migrar desde otro proveedor

Cambiar de proveedor de facturación no cambia nada ante Hacienda: tu cédula, tu certificado de firma y tus credenciales son tuyos. Lo que hay que cuidar es la numeración, porque un consecutivo usado no se repite nunca. Esta guía recorre la migración paso a paso.

Lo que traés

Elemento	Qué hacer
Certificado .p12 y su PIN	Reutilizalo: subilo a Aster con POST /organizations/me/certificate
Usuario y contraseña de comprobantes electrónicos	Reutilizalos en el mismo endpoint, en atv_user y atv_password
Actividades económicas, sucursales y terminales	Configuralas igual que las tenías
Último consecutivo por sucursal, terminal y tipo	Anotalos el día del corte; los necesitás para la numeración
XML históricos	Importalos a Archeion

Ver plataformas para el detalle de la carga del certificado y la verificación con GET /utils/verify-credentials.

Numeración

Hacienda rechaza un consecutivo repetido aunque el comprobante anterior haya sido rechazado. En la migración tenés tres opciones; elegí una por sucursal y terminal.

Opción A: seguí numerando vos

Si tu sistema ya lleva los contadores, seguí haciéndolo y enviá la clave y el consecutivo en cada comprobante:

document

{
  "document_type": "01",
  "activity_code": "475201",
  "date": "2026-10-08T10:15:00-06:00",
  "branch": "001",
  "terminal": "00001",
  "clave": "50608102600310165432100100001010000001042147201936",
  "consecutive_number": "00100001010000001042"
}

Aster valida lo que enviás antes de firmar:

Verificación	Respuesta si falla
clave y consecutive_number van juntos	422 invalid_clave_consecutive
La clave tiene 50 caracteres y el consecutivo 20 dígitos	422 invalid_clave_format / 422 invalid_consecutive_format
La fecha de la clave (posiciones 4 a 9) coincide con date	422 clave_date_mismatch (Hacienda -405)
La clave no existe ya en Aster	409 duplicate_clave
El consecutivo no se usó ya en ese ambiente	409 duplicate_consecutive

Aster solo conoce los consecutivos que pasaron por Aster. Los que usaste con tu proveedor anterior son tu responsabilidad.

Opción B: indicale a Aster dónde seguir

Si preferís que Aster numere, decile cuál es el siguiente número de cada contador:

Terminal

curl -X PUT https://aster.astranexo.com/api/v1/organizations/me/consecutives \
  -H "Authorization: Bearer aster_live_Q4mT8yWc2NvB6kHs" \
  -H "Content-Type: application/json" \
  --data '{
    "branch": "001",
    "terminal": "00001",
    "document_type": "01",
    "next_value": 1043
  }'

200 OK

{
  "success": true,
  "message": "Consecutivo updated.",
  "data": {
    "environment": "production",
    "branch": "001",
    "terminal": "00001",
    "document_type": "01",
    "next_value": 1043,
    "updated_at": "2026-10-08T12:00:00Z"
  }
}

Repetilo para cada combinación de sucursal, terminal y tipo de documento que uses (facturas, tiquetes, notas de crédito, etc.). El ambiente lo decide la llave: con una llave aster_live_ configurás los contadores de producción. GET /organizations/me/consecutives lista los contadores actuales.

Indicá siempre un número que nunca usaste: si el último consecutivo de facturas con tu proveedor anterior fue el 1042, el siguiente es 1043.

Opción C: usá una terminal nueva

La forma más simple de evitar choques: emití desde Aster con una terminal que nunca usaste (por ejemplo, 00002). Cada terminal tiene su propia secuencia y arranca en 1, así que no hay forma de repetir un número de la terminal vieja. Ver sucursal y terminal.

Prueba en paralelo

Antes del corte, corré Aster en paralelo con tu proveedor actual sin afectar producción:

1. Emití en pruebas. Con una llave aster_test_, enviá los mismos comprobantes que emitís hoy. Van al ambiente de pruebas de Hacienda, no cuentan para tu plan y no afectan tus consecutivos de producción. Si todavía no subiste el certificado de pruebas, Aster devuelve un veredicto simulado.
2. Compará los totales. Aster calcula subtotales, impuestos y resumen. Compará el total_amount y el tax_amount de cada comprobante con los de tu proveedor actual.
3. Validá datos reales sin emitir. POST /hacienda/validate acepta el mismo cuerpo que POST /electronic-documents y corre todas las validaciones sin firmar ni enviar. Sirve para revisar comprobantes de producción reales.
4. Probá los rechazos. Agregá "metadata": { "simulate": "rejected" } para verificar que tu sistema maneja un rechazo.

Webhooks en lugar de consultas

Si tu integración actual consulta el estado de cada comprobante en ciclo, aprovechá la migración para pasar a webhooks: Aster te avisa con document.accepted o document.rejected en cuanto Hacienda responde, con la firma verificable y reintentos durante unas 24 horas. Mantené la consulta por clave (GET /electronic-documents/{clave}) como respaldo.

Historial

Importá los XML que emitiste y recibiste con tu proveedor anterior a Archeion con POST /archive/import. Así tenés los 5 años en un solo lugar. La importación es gratis durante los primeros 12 meses del complemento.

Pedile a tu proveedor anterior la descarga completa de tus comprobantes antes de cerrar la cuenta: está obligado a permitírtela.

Lista de verificación del corte

• Plan pagado activo y llave aster_live_ creada para cada organización.
• Certificado de producción y credenciales subidos; GET /utils/verify-credentials?env=production responde valid: true.
• Último consecutivo anotado por sucursal, terminal y tipo, y numeración resuelta con la opción A, B o C.
• Webhook de producción registrado y verificación de firma probada con POST /webhooks/{id}/test.
• Llaves de idempotencia en cada POST (ver idempotencia).
• Prueba en paralelo sin diferencias de totales.
• Notas de crédito y débito probadas sobre comprobantes emitidos en Aster.
• Envío por correo configurado si lo usás (ver PDF y correo).
• Último comprobante emitido con el proveedor anterior y primer comprobante emitido con Aster, ambos aceptados.
• Historial importado a Archeion o descargado y guardado por tu cuenta.

Una nota de crédito sobre una factura emitida con tu proveedor anterior se puede emitir desde Aster: referenciala por su clave igual que cualquier otra. Ver nota de crédito.