Clientes de otros países

En España lo que decide cómo se identifica al comprador ante la AEAT no es un tipo de documento: es su país.

{
  "comprador": {
    "identificacion": "FR12345678901",
    "razon_social": "SOCIÉTÉ EXEMPLE SARL",
    "pais": "FR"
  }
}

pais	Cómo lo recibe la AEAT
Vacío o ES	NIF español
País de la UE	IDOtro con NIF-IVA intracomunitario
Fuera de la UE	IDOtro como identificación extranjera

El país es obligatorio si la identificación no es española

Sin él, la AEAT no sabe qué está recibiendo y la emisión se rechaza:

{
  "error": {
    "code": "document_rejected_before_issuing",
    "message": "La identificación del cliente no es un NIF español. Si el cliente es de otro país, indica su país."
  }
}

Guarda el país en la ficha del cliente

Si tu sistema no guarda el país de cada cliente, este es el momento de añadirlo. Es un dato que la facturación española necesita y que no se puede deducir de la identificación con fiabilidad.

Servicios a empresas de la UE

El caso más frecuente: prestas un servicio a una empresa de otro país de la UE. Suele aplicar la inversión del sujeto pasivo — el IVA lo declara el cliente en su país, no tú:

{
  "comprador": {
    "identificacion": "DE123456789",
    "razon_social": "BEISPIEL GMBH",
    "pais": "DE"
  },
  "items": [
    {
      "descripcion": "Servicios de consultoría",
      "cantidad": 1,
      "precio_unitario": 2000.00,
      "impuestos": [{ "codigo_impuesto": "ES_ISP_UE" }]
    }
  ],
  "totales": { "total_sin_impuestos": 2000.00, "importe_total": 2000.00 }
}

La factura sale sin cuota de IVA y con la mención legal correspondiente (art. 196 de la Directiva 2006/112/CE), que Olympus añade al PDF.

No todo a la UE es inversión del sujeto pasivo

Depende del tipo de operación y de si el cliente es empresa o particular. A un particular de otro país de la UE normalmente se le repercute IVA. Si no lo tienes claro, que lo confirme la asesoría del negocio: la API hace lo que le digas.

Clientes de fuera de la UE

{
  "comprador": {
    "identificacion": "US-987654321",
    "razon_social": "EXAMPLE CORP",
    "pais": "US"
  },
  "items": [
    {
      "descripcion": "Licencia de software",
      "cantidad": 1,
      "precio_unitario": 500.00,
      "impuestos": [{ "codigo_impuesto": "ES_NO_SUJETO_LOC" }]
    }
  ],
  "totales": { "total_sin_impuestos": 500.00, "importe_total": 500.00 }
}

Los servicios a clientes de fuera de la UE suelen quedar no sujetos por reglas de localización. La AEAT lo recibe como identificación extranjera.

Facturar en otra moneda

España admite divisas del BCE, no solo euros:

{
  "moneda": "USD",
  "comprador": { "identificacion": "US-987654321", "razon_social": "EXAMPLE CORP", "pais": "US" },
  "items": [ … ]
}

La factura se emite en esa moneda, pero el registro ante la AEAT y la cuota van siempre en euros, convertidos al tipo de cambio de referencia del BCE de la fecha de emisión, que queda fijado al expedir. El PDF muestra ambos importes.

Si la moneda no está permitida para el negocio, la respuesta es 422 currency_not_supported con la lista de las que sí.

Resumen

Cliente	pais	Impuesto típico
Empresa o particular español	vacío	ES_IVA_21 / ES_IVA_10 / ES_IVA_4
Empresa de la UE (servicios)	su país	ES_ISP_UE
Particular de la UE	su país	IVA español
Cliente de fuera de la UE (servicios)	su país	ES_NO_SUJETO_LOC

La columna del impuesto es orientativa: la operación concreta manda.