Emitir DE - e-Miti

POST /v1/de/emitir Crea un nuevo Documento Electrónico (factura, autofactura, nota de crédito, nota de débito o nota de remisión) y lo encola para envío a SIFEN. El campo tipo_de del body determina el tipo de documento:

`tipo_de`	Tipo	Tutorial
`1`	Factura electrónica	emitir-factura
`4`	Autofactura electrónica	emitir-autofactura
`5`	Nota de crédito electrónica	emitir-nota-credito
`6`	Nota de débito electrónica	—
`7`	Nota de remisión electrónica	emitir-nota-remision

Headers

Header	Requerido	Valores	Descripción
`Authorization`	sí	`ApiKey emiti_k_...`	Autenticación (ver autenticación).
`Content-Type`	sí	`application/json`
`X-Fuente`	no	`A` (default), `U`, `W`	Canal de emisión: `A` = API/sistema externo, `U` = UI de e-Miti, `W` = WhatsApp.

Query params

Parámetro	Tipo	Default	Descripción
`wait`	`boolean`	`false`	Espera la respuesta de SIFEN antes de retornar (modo sincrónico).
`timeout`	`integer` (1–25)	`10`	Segundos a esperar cuando `wait=true`.
`edit_cdc`	`string` (44 chars)	—	Si se envía, edita el DE rechazado con ese CDC en lugar de emitir uno nuevo. El payload debe mantener los campos identificatorios (tipo, serie, número, fecha).

Body

Campos principales (siempre)

Campo	Tipo	Requerido	Descripción
`establecimiento`	`string` (3 dígitos)	sí	Código EEE de la sucursal. Ej: `"001"`.
`punto`	`string` (3 dígitos)	sí	Código PPP del punto de expedición. Ej: `"001"`.
`tipo_de`	`integer`	no (default `1`)	Tipo de documento: `1` Factura, `4` Autofactura, `5` Nota de Crédito, `6` Nota de Débito, `7` Nota de Remisión.
`tipo_transaccion`	`integer`	condicional	Naturaleza de la operación. Obligatorio solo para `tipo_de: 1` (Factura) y `tipo_de: 4` (Autofactura). Se ignora si se envía para Nota de Crédito/Débito o Nota de Remisión — SIFEN no admite este dato en esos tipos. Ver tabla abajo.
`receptor`	`object`	sí	Datos del receptor. Ver objeto `receptor`.
`items`	`array`	sí (para tipos 1, 4, 5, 6)	Ítems con precio. Ver objeto `item`. `tipo_de: 7` (Nota de Remisión) usa `items_remision` en su lugar — sin precio ni IVA.
`fecha_emision`	`string` (ISO 8601)	no (default: ahora)	Fecha y hora de emisión. No puede ser futura ni anterior a 30 días.
`tipo_emision`	`integer`	no (default `1`)	`1` Normal, `2` Contingencia.
`sit`	`string`	no (default: usa punto.sit)	`"H"` Homologación, `"P"` Producción. Omitir para que el sistema use el ambiente configurado en el punto.
`modo_envio`	`string`	no (default: usa la config del punto)	Modo de envío del comprobante: `"S"` inmediato, `"A"` diferido. Omitir para usar el modo configurado en el punto de expedición. Ver Modo de envío.
`tipo_impuesto`	`integer`	no (auto-detectado)	Tipo de impuesto: `1` IVA, `2` ISC, `3` Renta, `4` Ninguno (exento), `5` IVA+Renta. Si se omite se deduce de los ítems.
`moneda`	`string` (3 chars)	no (default `"PYG"`)	Código ISO 4217 de la moneda del documento. Valores habilitados: `"PYG"`, `"USD"`, `"BRL"`. Ver Moneda extranjera.
`tipo_cambio`	`decimal`	condicional	Obligatorio si `moneda != "PYG"`. Tipo de cambio de la moneda respecto al guaraní (mayor a 0, hasta 4 decimales). Se aplica como cambio único para todo el documento.
`indicador_presencia`	`integer`	no (default `1`)	Indicador de presencia: `1` Presencial, `2` Electrónica, `3` Telemarketing, `4` Domicilio, `5` Bancaria, `6` Cíclica, `9` Otro.
`id_interno`	`string` (máx 50)	no	ID del documento en tu sistema. Habilita idempotencia: reintentar con el mismo `id_interno` devuelve el DE ya creado, sin duplicar.
`numero`	`integer` (> 0)	no	Forzar número de comprobante específico. Si se omite, el sistema asigna el siguiente correlativo.
`d_cod_seg`	`string` (9 dígitos)	no	Código de seguridad del DE. Si se omite, se genera automáticamente.
`condicion_venta`	`integer`	no (default `1` para factura/autofactura)	`1` Contado, `2` Crédito.
`pago_credito`	`object`	condicional	Obligatorio si `condicion_venta: 2`. Ver objeto `pago_credito`.
`formas_pago`	`array`	no	Medios de pago de una operación al contado (efectivo, transferencia, tarjeta, cheque, etc.). Si se omite, la operación se registra como pago en efectivo por el total. Ver objeto `forma_pago`.
`obras`	`array`	condicional	Obligatorio si `tipo_transaccion: 14` (Gasto de obra). Ver objeto `obra`.
`info_emisor`	`string` (1–3000 chars)	no	Texto libre del emisor sobre el documento (observaciones, referencias internas).
`info_fiscal`	`string` (1–3000 chars)	condicional	Texto libre dirigido al Fisco. Obligatorio para Nota de Remisión (`tipo_de: 7`) — Art. 3 Inc. 7 de la Resolución General Nro. 41/2014.

Campos específicos por tipo

Campo	Tipo	Requerido cuando	Descripción
`autofactura`	`object`	`tipo_de: 4`	Datos del vendedor no-contribuyente. Ver objeto `autofactura`.
`motivo_nc`	`integer`	`tipo_de: 5` o `6` (default `1` para NC, `6` para ND)	Motivo de la NC/ND. Mismo catálogo para ambos tipos — ver tabla de motivos.
`doc_asociado`	`object`	`tipo_de: 5` o `6`	Documento al que hace referencia la NC/ND. Ver objeto `doc_asociado`.
`items_remision`	`array`	`tipo_de: 7`	Ítems trasladados, sin precio ni IVA. Ver objeto `items_remision`.
`remision`	`object`	`tipo_de: 7`	Motivo, responsable y datos generales del traslado. Ver objeto `remision`.
`transporte`	`object`	`tipo_de: 7`	Datos del transporte: modalidad, fechas, locales, vehículos y transportista. Ver objeto `transporte`.

`tipo_transaccion` — valores

Valor	Significado
`1`	Venta de mercadería
`2`	Prestación de servicios
`3`	Mixto
`4`	Venta de activo fijo
`5`	Venta de divisas
`6`	Compra de divisas
`7`	Promoción / entretenimiento
`8`	Donación
`9`	Anticipo
`10`	Compra de productos
`11`	Compra de servicios
`12`	Venta de créditos fiscales
`13`	Muestras médicas
`14`	Gasto de obra (requiere `obras[]`)

Objeto `receptor`

Campo	Tipo	Default	Descripción
`nombre`	`string` (máx 255)	—	Requerido. Nombre o razón social del receptor.
`ruc`	`string`	`null`	RUC con DV (`XXXXXXXX-D`) si el receptor es contribuyente.
`nombre_fantasia`	`string` (máx 255)	`null`	Nombre de fantasía del receptor.
`tipo_contribuyente`	`integer`	`null`	`1` Persona física, `2` Persona jurídica.
`tipo_documento`	`integer`	`5` (Innominado)	Tipo de doc de identidad (cuando no es contribuyente): `1` CI PY, `2` Pasaporte, `3` CI extranjera, `4` Carnet residencia, `5` Innominado, `6` Tarjeta diplomática, `9` Otro.
`numero_documento`	`string` (máx 20)	`"0"`	Número del documento. `"0"` si innominado / consumidor final.
`direccion`	`string`	`null`	Dirección del receptor.
`numero_casa`	`integer`	`0`	Número de casa.
`codigo_departamento`	`integer` (1–20)	`null`	Código de departamento SET.
`descripcion_departamento`	`string` (máx 100)	`null`	Nombre del departamento.
`codigo_distrito`	`integer`	`null`	Código de distrito SET.
`descripcion_distrito`	`string` (máx 100)	`null`	Nombre del distrito.
`codigo_ciudad`	`integer`	`null`	Código de ciudad SET.
`descripcion_ciudad`	`string` (máx 100)	`null`	Nombre de la ciudad.
`celular`	`string` (máx 20)	`null`	Celular del receptor.
`email`	`string`	`null`	Email — e-Miti envía el KuDE a esta dirección si está presente.
`codigo_pais`	`string` (3 chars)	`"PRY"`	Código ISO 3166-1 alfa-3 del país del receptor.
`codigo_cliente`	`string` (3–15 caracteres)	`null`	Código interno del receptor en tu sistema. Opcional; si se envía, debe tener entre 3 y 15 caracteres (requisito de SIFEN).

Receptor no domiciliado (empresa extranjera): si el receptor no tiene ruc y codigo_pais es distinto de "PRY", numero_documento es obligatorio — no se acepta "0"/innominado. Usá tipo_documento: 2 (Pasaporte) o tipo_documento: 9 (Otro) según corresponda. Sin esto, la emisión falla con VALIDACION_RECEPTOR_EXTRANJERO_SIN_IDENTIFICADOR (ver Errores frecuentes).

Objeto `item`

Campos principales

Campo	Tipo	Default	Descripción
`descripcion`	`string` (máx 500)	—	Requerido. Descripción del bien o servicio.
`cantidad`	`decimal` (> 0)	—	Requerido. Cantidad (hasta 4 decimales).
`precio_unitario`	`decimal` (≥ 0)	—	Requerido. Precio unitario (hasta 2 decimales).
`iva_tipo`	`integer`	`1`	Tasa de IVA: `1` = 10%, `2` = 5%, `3` = Exento.
`descuento_porcentaje`	`decimal` (0–100)	`null`	Descuento porcentual sobre el subtotal.
`unidad_medida`	`integer`	`77`	Código de unidad de medida SET. `77` = Unidad.

Los campos derivados (subtotal, base_gravada_iva, liquidacion_iva) son calculados por e-Miti usando las fórmulas SIFEN — no los enviés.

Campos opcionales de identificación y catálogo

Todos null por defecto. Enviá solo los que correspondan para tu operación.

Campo	Tipo	Descripción
`codigo_interno`	`string` (1–20 chars)	Código del producto en tu catálogo. Si se omite, e-Miti genera un correlativo por ítem.
`partida_arancelaria`	`string` (4 dígitos)	Partida arancelaria del bien.
`ncm`	`string` (6–8 dígitos)	Nomenclatura Común del Mercosur.
`dncp_general`	`string` (8 chars)	Código DNCP nivel general. Si se envía, `dncp_especifico` es obligatorio.
`dncp_especifico`	`string` (3–4 chars)	Código DNCP nivel específico.
`gtin`	`string` (8, 12, 13 o 14 dígitos)	Código de barras GTIN del producto.
`gtin_paquete`	`string` (8, 12, 13 o 14 dígitos)	Código de barras GTIN del paquete/embalaje.
`pais_origen`	`string` (3 chars, código ISO)	País de origen del bien (ej. `"PRY"`, `"BRA"`). Si se envía, `descripcion_pais_origen` es obligatorio.
`descripcion_pais_origen`	`string` (4–30 chars)	Nombre del país de origen.
`info_item`	`string` (1–500 chars)	Texto libre del emisor sobre el ítem (observaciones, especificaciones).
`relevancia_mercaderia`	`integer` (`1` o `2`)	Tolerancia de quiebra (`1`) o tolerancia de merma (`2`). Si se envía, los campos de cantidad/porcentaje son obligatorios.
`descripcion_relevancia_mercaderia`	`string` (19–21 chars)	Descripción textual de la relevancia (`"Tolerancia de quiebra"` / `"Tolerancia de merma"`).
`cantidad_quiebra_merma`	`decimal` (≥ 0, hasta 4 dec.)	Cantidad de quiebra o merma.
`porcentaje_quiebra_merma`	`decimal` (0–100, hasta 8 dec.)	Porcentaje de quiebra o merma.
`cdc_anticipo`	`string` (44 dígitos)	CDC del anticipo relacionado. Requerido por SIFEN cuando `tipo_transaccion: 9` (Anticipo).
`rastreo_mercaderia`	`object`	Grupo de trazabilidad del ítem: lote, vencimiento, importador. Ver objeto `rastreo_mercaderia`.

Objeto `rastreo_mercaderia`

Todos los campos son opcionales. Completá solo los que tu operación requiera (lote para alimentos, importador para agroquímicos, etc.).

Campo	Tipo	Descripción
`numero_lote`	`string` (1–80 chars)	Número de lote del producto.
`fecha_vencimiento`	`string` (YYYY-MM-DD)	Fecha de vencimiento de la mercadería.
`numero_serie`	`string` (1–10 chars)	Número de serie del producto.
`numero_pedido`	`string` (1–20 chars)	Número de pedido de compra asociado.
`numero_seguimiento`	`string` (1–20 chars)	Número de seguimiento del envío.
`nombre_importador`	`string` (4–60 chars)	Nombre del importador (agroquímicos RG 16/2019).
`direccion_importador`	`string` (1–255 chars)	Dirección del importador.
`numero_firma_importador`	`string` (1–20 chars)	Número de firma del importador.
`numero_registro_senave`	`string` (1–20 chars)	Número de registro SENAVE.
`numero_registro_entidad_comercial`	`string` (1–20 chars)	Número de registro en entidad comercial.

Objeto `pago_credito`

Requerido cuando condicion_venta: 2.

Campo	Tipo	Requerido cuando	Descripción
`tipo_cred`	`integer`	siempre	`1` Plazo, `2` Cuotas.
`fecha_vencimiento`	`string` (YYYY-MM-DD)	`tipo_cred: 1`	Fecha de vencimiento del crédito. Debe ser posterior a `fecha_emision` — la plataforma calcula automáticamente la cantidad de días.
`cuotas`	`integer` (1–99)	`tipo_cred: 2`	Cantidad de cuotas.
`monto_entrega`	`decimal` (≥ 0)	no	Monto de entrega inicial (anticipo).

Objeto `forma_pago`

Cada elemento del array formas_pago describe un medio de pago de una operación al contado (condicion_venta: 1). Podés informar varios medios (multi-pago): en ese caso monto es obligatorio en cada uno y la suma debe coincidir con el total del DE. Si formas_pago se omite, la operación se registra como efectivo por el total.

Campo	Tipo	Requerido cuando	Descripción
`tipo_pago`	`integer`	siempre	Código del medio de pago. Ver tabla de códigos abajo.
`monto`	`decimal` (> 0)	multi-pago	Monto pagado con este medio. Opcional en pago único (se toma el total).
`descripcion`	`string` (4–30)	`tipo_pago: 99`	Descripción libre del medio de pago (solo para “Otro”).
`tarjeta`	`object`	`tipo_pago: 3, 4, 8`	Datos de la tarjeta. Ver objeto `tarjeta`.
`cheque`	`object`	`tipo_pago: 2`	Datos del cheque. Ver objeto `cheque`.

Códigos de tipo_pago:

Código	Medio	Código	Medio
`1`	Efectivo	`11`	Pago por anticipo
`2`	Cheque	`12`	Valor fiscal
`3`	Tarjeta de crédito	`13`	Valor comercial
`4`	Tarjeta de débito	`14`	Compensación
`5`	Transferencia	`15`	Permuta
`6`	Giro	`16`	Pago bancario
`7`	Billetera electrónica	`17`	Pago móvil
`8`	Tarjeta empresarial	`18`	Donación
`9`	Vale	`19`	Promoción
`10`	Retención	`20`	Consumo interno
		`21`	Pago electrónico
		`99`	Otro (requiere `descripcion`)

Objeto `tarjeta`

Requerido cuando tipo_pago es 3 (crédito), 4 (débito) u 8 (empresarial).

Campo	Tipo	Requerido cuando	Descripción
`denominacion`	`integer`	siempre	`1` Visa, `2` Mastercard, `3` American Express, `4` Maestro, `5` Panal, `6` Cabal, `99` Otro.
`descripcion_denominacion`	`string` (4–20)	`denominacion: 99`	Descripción libre de la tarjeta.
`razon_social_procesador`	`string` (4–60)	no	Razón social del procesador de la tarjeta.
`ruc_procesador`	`string` (máx 8)	no	RUC del procesador.
`dv_procesador`	`integer` (0–9)	no	Dígito verificador del RUC del procesador.
`forma_procesamiento`	`integer`	no (default `1`)	`1` POS, `2` Pago electrónico, `9` Otro.
`codigo_autorizacion`	`integer` (≥ 100000)	no	Código de autorización de la operación.
`nombre_titular`	`string` (4–30)	no	Nombre del titular de la tarjeta.
`numero_tarjeta`	`integer` (0–9999)	no	Últimos 4 dígitos de la tarjeta.

Objeto `cheque`

Requerido cuando tipo_pago: 2.

Campo	Tipo	Requerido cuando	Descripción
`numero_cheque`	`string` (8 dígitos)	siempre	Número del cheque.
`banco_emisor`	`string` (4–20)	siempre	Banco emisor del cheque.

Objeto `autofactura`

Requerido cuando tipo_de: 4. Describe al vendedor no-contribuyente.

Campo	Tipo	Descripción
`naturaleza_vendedor`	`integer`	`1` No-contribuyente (default), `2` Extranjero.
`tipo_documento`	`integer`	`1` CI PY (default), `2` Pasaporte, `3` CI extranjera, `4` Carnet residencia.
`numero_documento`	`string` (máx 20)	CI, pasaporte u otro.
`nombre`	`string` (máx 255)	Nombre completo del vendedor.
`direccion`	`string` (máx 255)	Dirección del vendedor.
`numero_casa`	`integer`	Default `0`.
`codigo_departamento`	`integer` (1–20)	Código SET del departamento del vendedor.
`ciudad`	`string` (máx 100)	Ciudad del vendedor.
`codigo_ciudad`	`integer`	Código SET de la ciudad del vendedor.
`direccion_provision`	`string` (máx 255)	Lugar donde se entregó el bien o prestó el servicio.
`codigo_departamento_provision`	`integer` (1–20)	Departamento de provisión.
`ciudad_provision`	`string` (máx 100)	Ciudad de provisión.
`codigo_ciudad_provision`	`integer`	Código SET de la ciudad de provisión.

Objeto `doc_asociado`

Requerido cuando tipo_de: 5 (Nota de Crédito) o tipo_de: 6 (Nota de Débito).

Campo	Tipo	Requerido cuando	Descripción
`tipo`	`integer`	siempre	`1` Electrónico (default), `2` Impreso, `3` Constancia.
`cdc`	`string` (44 chars)	`tipo: 1`	CDC del DE referenciado.
`timbrado`	`string`	`tipo: 2`	Timbrado del documento impreso.
`establecimiento`	`string`	`tipo: 2`	Establecimiento del doc impreso.
`punto`	`string`	`tipo: 2`	Punto del doc impreso.
`numero`	`string`	`tipo: 2`	Número del doc impreso.
`fecha`	`string` (YYYY-MM-DD)	`tipo: 2`	Fecha del doc impreso.
`constancia_tipo`	`integer`	`tipo: 3`	`1` No-contribuyente, `2` Microproductores.
`constancia_numero`	`string` (hasta 15 dígitos)	`tipo: 3`	Número de la constancia.
`constancia_control`	`string` (8 chars alfanuméricos)	no	Control de la constancia.

Objeto `obra`

Requerido cuando tipo_transaccion: 14 (Gasto de obra). Al menos una obra.

Campo	Tipo	Descripción
`nombre`	`string` (máx 300)	Requerido. Denominación de la obra pública (`dNombObra`).

Objeto `items_remision`

Requerido cuando tipo_de: 7. Ítems trasladados — sin precio ni IVA, a diferencia del objeto item.

Campo	Tipo	Default	Descripción
`descripcion`	`string` (máx 500)	—	Requerido. Descripción del bien trasladado.
`cantidad`	`decimal` (> 0)	—	Requerido. Cantidad (hasta 4 decimales).
`unidad_medida`	`integer`	`77`	Código de unidad de medida SET. `77` = Unidad.

Acepta además los mismos campos opcionales de identificación y catálogo comercial que el objeto item (codigo_interno, partida_arancelaria, ncm, dncp_general/dncp_especifico, gtin, gtin_paquete, pais_origen/descripcion_pais_origen, info_item, relevancia_mercaderia y campos derivados, cdc_anticipo, rastreo_mercaderia) — con las mismas reglas de dependencia entre campos.

Objeto `remision`

Requerido cuando tipo_de: 7. Datos generales del traslado (motivo, responsable, kilómetros).

Campo	Tipo	Default	Descripción
`motivo`	`integer`	`1`	Motivo de la remisión. Ver tabla de motivos.
`descripcion_motivo`	`string` (5–60 chars)	`null`	Descripción libre — obligatoria si `motivo: 99` (Otro). Para los demás valores, e-Miti deriva la descripción del catálogo.
`responsable`	`integer`	`1`	Responsable de la emisión. Ver tabla de responsables.
`kilometros`	`integer` (1–99999)	`1`	Kilómetros estimados de recorrido.
`fecha_factura`	`string` (YYYY-MM-DD)	`null`	Fecha de la factura asociada al traslado. Obligatoria si `motivo: 1` (traslado por venta) y no se envía `doc_asociado`.
`costo_flete`	`decimal` (≥ 0)	`null`	Costo del flete.

`remision.motivo` — valores

Valor	Motivo
`1`	Traslado por venta (default)
`2`	Traslado por consignación
`3`	Exportación
`4`	Traslado por compra
`5`	Importación (requiere `transporte.numero_despacho`)
`6`	Traslado por devolución
`7`	Traslado entre locales de la misma empresa
`8`	Traslado por transformación
`9`	Traslado para reparación
`10`	Traslado de emisor móvil
`11`	Exhibición
`12`	Ferias
`13`	Encomienda
`14`	Decomiso
`99`	Otro (requiere `descripcion_motivo`)

`remision.responsable` — valores

Valor	Responsable
`1`	Emisor de la factura (default)
`2`	Poseedor de la factura
`3`	Empresa transportista
`4`	Despachante de aduanas
`5`	Agente de transporte

Objeto `transporte`

Requerido cuando tipo_de: 7. Además de los campos propios, local_salida, al menos un elemento en locales_entrega, al menos un elemento en vehiculos y transportista son obligatorios para toda Nota de Remisión (SIFEN los declara opcionales en el XSD pero los rechaza igual si faltan — e-Miti valida esto antes de enviar).

Campo	Tipo	Default	Descripción
`tipo_transporte`	`integer` (1–2)	`null`	Requerido. `1` Propio, `2` Tercero.
`modalidad`	`integer` (1–4)	`1`	Modalidad: `1` Terrestre, `2` Fluvial, `3` Aéreo, `4` Multimodal. Si es `3` (Aérea), `numero_vuelo` es obligatorio en cada vehículo.
`responsable_flete`	`integer` (1–5)	`1`	`1` Emisor FE, `2` Receptor FE, `3` Tercero, `4` Agente intermediario, `5` Transporte propio.
`condicion_negociacion`	`string`	`null`	Incoterm: `CFR`, `CIF`, `CIP`, `CPT`, `DAP`, `DAT`, `DDP`, `EXW`, `FAS`, `FCA` o `FOB`.
`numero_manifiesto`	`string` (máx 15)	`null`	Número de manifiesto de carga.
`numero_despacho`	`string` (16 chars)	`null`	Número de despacho de importación. Obligatorio si `remision.motivo: 5` (Importación).
`fecha_inicio_traslado`	`string` (YYYY-MM-DD)	`null`	Requerido. Fecha de inicio del traslado (≥ 2018-05-01).
`fecha_fin_traslado`	`string` (YYYY-MM-DD)	`null`	Requerido. Fecha de fin del traslado. Debe ser igual o posterior a `fecha_inicio_traslado`.
`codigo_pais_destino`	`string` (3 chars)	`null`	País de destino (código ISO), para exportación.
`descripcion_pais_destino`	`string` (4–50 chars)	`null`	Nombre del país de destino.
`local_salida`	`object`	—	Requerido. Local desde donde sale la mercadería. Ver objeto local.
`locales_entrega`	`array` (máx 99)	`[]`	Requerido, al menos uno. Locales donde se entrega la mercadería. Ver objeto local.
`vehiculos`	`array` (máx 4)	`[]`	Requerido, al menos uno. Vehículos usados en el traslado. Ver objeto vehículo.
`transportista`	`object`	`null`	Requerido. Datos del transportista y del chofer. Ver objeto transportista.

Objeto `local_salida` / `locales_entrega`

Mismo shape para el local de salida (local_salida, un objeto) y los locales de entrega (locales_entrega, un array).

Campo	Tipo	Default	Descripción
`direccion`	`string` (máx 255)	—	Requerido. Dirección del local.
`numero_casa`	`integer` (0–999999)	`0`	Número de casa.
`complemento1`	`string` (máx 255)	`null`	Complemento de dirección 1.
`complemento2`	`string` (máx 255)	`null`	Complemento de dirección 2.
`codigo_departamento`	`integer` (1–20)	—	Requerido. Código de departamento SET.
`descripcion_departamento`	`string`	`null`	Nombre del departamento. Se deriva del código si no se envía.
`codigo_distrito`	`integer` (1–9999)	`null`	Código de distrito SET.
`descripcion_distrito`	`string` (1–30 chars)	`null`	Nombre del distrito.
`codigo_ciudad`	`integer` (1–99999)	—	Requerido. Código de ciudad SET.
`descripcion_ciudad`	`string` (1–30 chars)	—	Requerido. Nombre de la ciudad.
`telefono`	`string` (6–15 chars)	`null`	Teléfono de contacto del local.

Objeto `vehiculos`

Cada elemento del array transporte.vehiculos (0 a 4 vehículos).

Campo	Tipo	Default	Descripción
`tipo_vehiculo`	`string` (4–10 chars)	—	Requerido. Tipo de vehículo.
`marca`	`string` (1–10 chars)	—	Requerido. Marca del vehículo.
`tipo_identificacion`	`integer` (1–2)	—	Requerido. `1` por número de identificación, `2` por matrícula.
`numero_identificacion`	`string` (1–20 chars)	`null`	Obligatorio si `tipo_identificacion: 1`.
`adicional`	`string` (1–20 chars)	`null`	Dato adicional del vehículo.
`numero_matricula`	`string` (1–7 chars)	`null`	Obligatorio si `tipo_identificacion: 2`.
`numero_vuelo`	`string` (6 chars exactos)	`null`	Obligatorio si `transporte.modalidad: 3` (Aérea) — en cada vehículo.

Objeto `transportista`

Datos del transportista y del chofer (el bloque de chofer es siempre obligatorio).

Campo	Tipo	Default	Descripción
`naturaleza`	`integer` (1–2)	—	Requerido. `1` Contribuyente, `2` No contribuyente.
`nombre`	`string` (4–60 chars)	—	Requerido. Nombre o razón social del transportista.
`ruc`	`string` (3–8 chars)	`null`	RUC sin DV. Obligatorio si `naturaleza: 1`.
`dv_ruc`	`integer` (0–9)	`null`	Dígito verificador del RUC.
`tipo_documento`	`integer` (1–4)	`null`	Tipo de documento. Obligatorio si `naturaleza: 2`, junto con `numero_documento`.
`numero_documento`	`string` (1–20 chars)	`null`	Número de documento del transportista (si no es contribuyente).
`codigo_nacionalidad`	`string`	`null`	Código de país de nacionalidad.
`descripcion_nacionalidad`	`string` (4–50 chars)	`null`	Nombre del país de nacionalidad.
`chofer_documento`	`string` (1–20 chars)	—	Requerido. Documento del chofer.
`chofer_nombre`	`string` (4–60 chars)	—	Requerido. Nombre del chofer.
`chofer_domicilio_fiscal`	`string` (1–150 chars)	—	Requerido. Domicilio fiscal del chofer.
`chofer_direccion`	`string` (1–255 chars)	—	Requerido. Dirección del chofer.
`agente_nombre`	`string` (4–60 chars)	`null`	Nombre del agente de transporte (si aplica).
`agente_ruc`	`string` (3–8 chars)	`null`	RUC del agente (sin DV).
`agente_dv`	`integer` (0–9)	`null`	Dígito verificador del RUC del agente.
`agente_direccion`	`string` (1–255 chars)	`null`	Dirección del agente.

Para Nota de Remisión, el receptor también necesita domicilio completo: direccion siempre, y si el receptor está domiciliado en Paraguay (tiene ruc o codigo_pais: "PRY"), además codigo_departamento, codigo_ciudad y descripcion_ciudad. Ver el error NR_RECEPTOR_DOMICILIO_FALTANTE más abajo.

`motivo_nc` — valores

El catálogo de motivos es único y vale tanto para Nota de Crédito (tipo_de: 5) como para Nota de Débito (tipo_de: 6) — cualquier valor 1–8 es válido en ambos tipos.

Valor	Motivo
`1`	Devolución y ajuste de precios (default en NC)
`2`	Devolución
`3`	Descuento
`4`	Bonificación
`5`	Crédito incobrable
`6`	Recupero de costo (default en ND)
`7`	Recupero de gasto
`8`	Ajuste de precio

Sobre-acreditación (solo NC)

Para Nota de Crédito, el total de la NC (sumado a otras NC aprobadas sobre el mismo doc_asociado.cdc) no puede superar el total del documento referenciado — devuelve 422 NC_SOBRE_ACREDITACION si se excede. Este límite no aplica a Nota de Débito: un débito es un cargo adicional y puede superar el total del documento referenciado.

Respuesta

Modo asíncrono (`wait=false`, default)

El DE se encola para envío a SIFEN. Recibís 200 inmediatamente con estado: "P" (pendiente). Hacé polling con GET /v1/de?cdc=... hasta que pase a A o R.

{
  "cdc": "01548730457001001000000012026070712345678X",
  "de_id": "01948b3c-1234-7890-abcd-ef0123456789",
  "id_interno": "FAC-2026-0001",
  "numero": "001-001-0000001",
  "estado": "P",
  "sit": "H",
  "xml_s3_key": "h/001-001/factura/01948b3c-...",
  "kude_url": "https://s3.amazonaws.com/.../01548730...pdf?X-Amz-..."
}

Campo	Tipo	Descripción
`cdc`	`string` (44 chars)	Código de Control del DE. Identificador único SIFEN.
`de_id`	`string` (UUID)	ID interno del DE en e-Miti. Usado en `/reencolar` y `/reenviar-email`.
`id_interno`	`string` \| `null`	ID del documento en tu sistema (si lo enviaste).
`numero`	`string`	Número formateado del DE (`EEE-PPP-NNNNNNN`).
`estado`	`"P"`	Siempre `P` en modo asíncrono (pendiente de envío a SIFEN).
`sit`	`"H"` \| `"P"`	Ambiente del DE.
`xml_s3_key`	`string`	Key S3 del XML firmado (para auditoría interna).
`kude_url`	`string` \| `null`	URL pre-firmada (1 hora) del KuDE listo para imprimir, disponible al instante — sin esperar la respuesta de SIFEN. Ideal para imprimir en el punto de venta apenas se emite. `null` si la representación no pudo generarse (la emisión sigue siendo válida).

El kude_url está disponible apenas emitís, en estado P, para que puedas imprimir el comprobante en el acto (por ejemplo, en la caja de un comercio). Cuando SIFEN aprueba el documento, e-Miti actualiza la representación a su versión definitiva; podés obtener siempre la más reciente con GET /v1/de/{cdc}/kude. El kude_url también aparece en la respuesta del modo sincrónico.

Modo sincrónico (`wait=true`)

La API hace polling hasta recibir respuesta de SIFEN o agotar el timeout. Aprobado (200):

{
  "cdc": "...",
  "de_id": "...",
  "numero": "001-001-0000001",
  "estado": "A",
  "sit": "H",
  "appr_at": "2026-07-07T10:00:00",
  "resp": { "protocolo": "2026070712348", "codigo": "0200" }
}

Timeout sin respuesta SIFEN (200 con pending: true):

{
  "cdc": "...",
  "estado": "P",
  "pending": true,
  "appr_at": null,
  "resp": null
}

Cuando pending: true, el DE sigue siendo procesado por el worker. Hacé polling por GET /v1/de?cdc=.... Rechazado (422 SIFEN_RECHAZO) — mismo shape de error estándar con extra.codigo_sifen y extra.cdc.

Campo extra	Descripción
`estado`	`"A"` (aprobado) o `"P"`/`"E"` (aún en proceso).
`appr_at`	ISO 8601 — timestamp de aprobación SIFEN. `null` si no aprobado aún.
`resp`	Objeto con respuesta SIFEN: `protocolo`, `codigo`, `mensaje`. `null` si aún no hay respuesta.
`pending`	`true` si el timeout se agotó y el DE sigue pendiente.

Ejemplo: ítem con campos opcionales

El siguiente fragmento muestra un ítem con los campos opcionales más frecuentes. Incluí solo los que apliquen a tu operación — todos son null por defecto.

{
  "descripcion": "Herbicida Roundup 1L",
  "cantidad": "100.0",
  "precio_unitario": "85000.00",
  "iva_tipo": 1,
  "unidad_medida": 77,
  "codigo_interno": "HERB-001",
  "ncm": "380893",
  "gtin": "07501234567890",
  "pais_origen": "ARG",
  "descripcion_pais_origen": "Argentina",
  "info_item": "Registro SENAVE 2024/001",
  "rastreo_mercaderia": {
    "numero_lote": "LOTE-2026-A",
    "fecha_vencimiento": "2028-12-31",
    "nombre_importador": "Importaciones Agro SA",
    "numero_registro_senave": "SV-2024-001"
  }
}

Para una factura de anticipos, agregá cdc_anticipo (44 dígitos) con el CDC del DE de anticipo previo. Para mercadería con tolerancia de quiebra, usá relevancia_mercaderia: 1 junto con cantidad_quiebra_merma y porcentaje_quiebra_merma.

Moneda extranjera

Podés emitir en moneda extranjera enviando moneda con el código ISO 4217 y tipo_cambio con la cotización respecto al guaraní. Las monedas habilitadas son:

`moneda`	Moneda
`"PYG"`	Guaraní (default)
`"USD"`	Dólar americano
`"BRL"`	Real brasileño

El tipo_cambio es un valor único que aplica a todo el documento (condición global): no se declara un cambio distinto por ítem. Debe ser mayor a 0 y admite hasta 4 decimales. El valor lo declarás vos — e-Miti no lo completa ni lo valida contra una fuente oficial. Los importes de los ítems y totales viajan con 2 decimales cuando la moneda es distinta de PYG. e-Miti calcula además el total general convertido a guaraníes (total × tipo_cambio) que exige SIFEN.

{
  "establecimiento": "001",
  "punto": "001",
  "tipo_de": 1,
  "tipo_transaccion": 2,
  "moneda": "USD",
  "tipo_cambio": "7350.0000",
  "receptor": {
    "ruc": "80099999-1",
    "nombre": "Cliente Exterior S.A."
  },
  "items": [
    {
      "descripcion": "Servicio de consultoría",
      "cantidad": "1",
      "precio_unitario": "100.00",
      "iva_tipo": 1
    }
  ]
}

Si enviás una moneda que no está habilitada, la emisión falla con VALIDACION_MONEDA_NO_HABILITADA (ver Errores frecuentes).

Modo de envío

Cada punto de expedición tiene un modo de envío configurado que determina cómo se procesa el comprobante. Podés dejar que la emisión use esa configuración (omitiendo modo_envio) o forzar un modo puntual en el request.

Valor	Modo	Comportamiento
`"A"`	Diferido	El comprobante se procesa en segundo plano. La respuesta llega en estado `P` (pendiente) y el resultado final se consulta luego por `GET /v1/de?cdc=...` o usando `wait=true`.
`"S"`	Inmediato	El comprobante se procesa apenas se emite. Con `wait=true` la respuesta ya trae el resultado final (aprobado o rechazado) en la misma llamada.

Si omitís modo_envio, se usa el modo configurado en el punto de expedición (por defecto, diferido). El modo elegido no cambia la validez del comprobante — solo cuándo obtenés la respuesta final.

Idempotencia

Si enviás id_interno, reintentar el mismo request con el mismo valor devuelve el DE ya creado (sin duplicar) y un 200. El estado puede ser distinto del P original si el worker ya procesó el documento.

Errores frecuentes

Código	Causa	Acción
`VALIDACION_MULTIPLES_CAMPOS`	Campos requeridos faltantes o inválidos.	Revisar `extra.errores[]`.
`VALIDACION_RECEPTOR_EXTRANJERO_SIN_IDENTIFICADOR`	Receptor sin `ruc` y `codigo_pais` distinto de `"PRY"`, pero sin `numero_documento` (o `"0"`).	Completar `tipo_documento` y `numero_documento` del receptor.
`VALIDACION_MONEDA_NO_HABILITADA`	`moneda` fuera de las habilitadas.	Usar una moneda habilitada: `PYG`, `USD` o `BRL`.
`AutofacturaSoloExentoError`	Ítems con IVA en autofactura (`tipo_de: 4`).	Cambiar todos los ítems a `iva_tipo: 3`.
`NC_SOBRE_ACREDITACION`	Solo NC: el total de la NC supera el disponible del documento referenciado.	Emitir por un monto menor o revisar NC ya emitidas sobre ese CDC.
`VALIDACION_MONEDA_REFERENCIA`	Solo NC/ND: la `moneda` no coincide con la del documento referenciado en `doc_asociado.cdc`.	Emitir la NC/ND en la misma moneda que el documento original (el tipo de cambio puede diferir).
`NR_RECEPTOR_DOMICILIO_FALTANTE`	Solo Nota de Remisión: falta el domicilio del receptor (dirección, departamento o ciudad).	Completar `direccion`, `codigo_departamento`, `codigo_ciudad` y `descripcion_ciudad` del receptor. Ver `extra.faltantes`.
`NR_FECHA_FACTURA_FALTANTE`	Solo Nota de Remisión por venta (`remision.motivo: 1`) sin factura referenciada: falta `remision.fecha_factura`.	Completar `remision.fecha_factura` (fecha estimada de emisión de la factura).
`NR_TRANSPORTE_INCOMPLETO`	Solo Nota de Remisión: faltan datos de transporte obligatorios (tipo de transporte, fechas de traslado, local de salida/entrega, vehículo, transportista o despacho de importación).	Completar los campos listados en `extra.faltantes`.
`NR_TRANSPORTE_FECHA_TRASLADO_INVALIDA`	Solo Nota de Remisión: `transporte.fecha_fin_traslado` es anterior a `transporte.fecha_inicio_traslado`.	Ajustar las fechas de traslado.
`NR_VEHICULO_NUMERO_VUELO_FALTANTE`	Solo Nota de Remisión aérea (`transporte.modalidad: 3`): falta `numero_vuelo` en algún vehículo.	Completar `numero_vuelo` (6 caracteres) en cada vehículo.
`NR_INFO_FISCAL_FALTANTE`	Solo Nota de Remisión: falta `info_fiscal`.	Completar `info_fiscal` con el mensaje al Fisco (Art. 3 Inc. 7 RG 41/2014).
`TIPO_DE_NO_PERMITIDO`	El usuario autenticado no tiene permiso para emitir ese tipo de documento. No aplica a emisión vía API key.	Verificar los tipos habilitados para el usuario o contactar al administrador del tenant.
`TIPO_DE_NO_SOPORTADO`	`tipo_de` no tiene builder implementado (`2`, `3` u `8`).	Usar uno de los tipos soportados: `1`, `4`, `5`, `6` o `7`.
`SIFEN_RECHAZO` (solo con `wait=true`)	SIFEN rechazó el documento.	Revisar `extra.codigo_sifen`. Ver errores SIFEN.
`EDICION_REQUIERE_CDC_NUEVO`	Con `edit_cdc`: los cambios modificarían el CDC.	Emitir un DE nuevo sin `edit_cdc`.

​Headers

​Query params

​Body

​Campos principales (siempre)

​Campos específicos por tipo

​tipo_transaccion — valores

​Objeto receptor

​Objeto item

​Campos principales

​Campos opcionales de identificación y catálogo

​Objeto rastreo_mercaderia

​Objeto pago_credito

​Objeto forma_pago

​Objeto tarjeta

​Objeto cheque

​Objeto autofactura

​Objeto doc_asociado

​Objeto obra

​Objeto items_remision

​Objeto remision

​remision.motivo — valores

​remision.responsable — valores

​Objeto transporte

​Objeto local_salida / locales_entrega

​Objeto vehiculos

​Objeto transportista

​motivo_nc — valores

​Sobre-acreditación (solo NC)

​Respuesta

​Modo asíncrono (wait=false, default)

​Modo sincrónico (wait=true)

​Ejemplo: ítem con campos opcionales

​Moneda extranjera

​Modo de envío

​Idempotencia

​Errores frecuentes

Headers

Query params

Body

Campos principales (siempre)

Campos específicos por tipo

`tipo_transaccion` — valores

Objeto `receptor`

Objeto `item`

Campos principales

Campos opcionales de identificación y catálogo

Objeto `rastreo_mercaderia`

Objeto `pago_credito`

Objeto `forma_pago`

Objeto `tarjeta`

Objeto `cheque`

Objeto `autofactura`

Objeto `doc_asociado`

Objeto `obra`

Objeto `items_remision`

Objeto `remision`

`remision.motivo` — valores

`remision.responsable` — valores

Objeto `transporte`

Objeto `local_salida` / `locales_entrega`

Objeto `vehiculos`

Objeto `transportista`

`motivo_nc` — valores

Sobre-acreditación (solo NC)

Respuesta

Modo asíncrono (`wait=false`, default)

Modo sincrónico (`wait=true`)

Ejemplo: ítem con campos opcionales

Moneda extranjera

Modo de envío

Idempotencia

Errores frecuentes