Receptor B2B y B2C
Cómo estructurar el receptor para facturas a otros contribuyentes (B2B con RUC) vs. consumidores finales (B2C) y documentos innominados.
El bloque receptor define a quién va dirigido el documento electrónico. SIFEN distingue tres situaciones principales, y elegir mal el tipo es la causa más común de rechazos en producción.
Cuándo usar cada tipo
| Caso | tipoOperacion | tipoContribuyente | Datos requeridos |
|---|---|---|---|
| Venta a empresa con RUC (deduce IVA) | B2B | CONTRIBUYENTE | RUC + razón social + dirección |
| Venta a persona física identificada | B2C | NO_CONTRIBUYENTE o NOMINADO | Cédula + nombre |
| Consumo final hasta Gs. 5.000.000 sin identificar | B2C | INNOMINADO | Ninguno |
Los valores aceptados de tipoContribuyente son: CONTRIBUYENTE, NO_CONTRIBUYENTE, EXTRANJERO, NOMINADO, INNOMINADO. Y los de tipoOperacion: B2B, B2C, B2G (gobierno) y B2F (extranjero).
B2C innominado
Es el caso más simple: ventas al consumidor final por hasta Gs. 5.000.000 donde no hace falta pedir documento. Cuando tipoContribuyente es INNOMINADO, no se cargan datos de identificación.
{
"receptor": {
"tipoContribuyente": "INNOMINADO",
"tipoOperacion": "B2C"
}
}Restricción: las Notas de Crédito y Notas de Débito electrónicas no admiten receptor innominado (NT-010 / NT-023). Si querés anular o ajustar una FE innominada, vas a tener que identificar al receptor en la NCE/NDE.
B2C identificado
Para ventas a personas físicas con cédula cuando el monto supera Gs. 5.000.000, o el cliente lo solicita explícitamente.
{
"receptor": {
"tipoContribuyente": "NO_CONTRIBUYENTE",
"tipoOperacion": "B2C",
"tipoDocumento": "CEDULA_PARAGUAYA",
"numeroDocumento": "1234567",
"nombreRazonSocial": "Juan Pérez",
"direccion": "Av. España 1234, Asunción"
}
}Otros tipos de documento aceptados para B2C cuando no hay cédula paraguaya:
tipoDocumento | Cuándo usarlo |
|---|---|
CEDULA_PARAGUAYA | Cédula de identidad paraguaya |
PASAPORTE | Extranjero sin cédula |
CARNET_DE_RESIDENCIA | Residente extranjero |
CEDULA_EXTRANJERA | Cédula de identidad extranjera |
TARJETA_DIPLOMATICA | Tarjeta diplomática |
OTRO | Otro identificador no contemplado arriba |
B2B (factura a empresa)
Cuando el receptor es otro contribuyente que va a deducir IVA, el RUC es obligatorio. Sifende valida el RUC contra el padrón de la SET.
{
"receptor": {
"tipoContribuyente": "CONTRIBUYENTE",
"tipoOperacion": "B2B",
"numeroDocumento": "80012345",
"digitoVerificador": "1",
"nombreRazonSocial": "Comercial Guaraní S.A.",
"direccion": "Av. Mariscal López 4567, Asunción"
}
}Para B2B, no enviés tipoDocumento: el RUC se identifica por tipoOperacion: "B2B" + tipoContribuyente: "CONTRIBUYENTE". Separás el número y el dígito verificador en dos campos: numeroDocumento: "80012345" y digitoVerificador: "1".
Cuándo es obligatorio facturar B2B
- Tu cliente es una empresa (PJ o EIRL).
- Te pide factura crédito fiscal.
- El monto supera Gs. 5.000.000 y el cliente tiene RUC.
- Vas a registrar la operación contra cuenta corriente del receptor.
Restricciones según tipo de documento
| Tipo de documento | Innominado | B2C identificado | B2B con RUC |
|---|---|---|---|
| Factura Electrónica (FE) | ✅ | ✅ | ✅ |
| Nota de Crédito (NCE) | ❌ | ✅ | ✅ |
| Nota de Débito (NDE) | ❌ | ✅ | ✅ |
Errores frecuentes
| SIFEN | Causa | Solución |
|---|---|---|
| 1302 | Falta tipoContribuyente para receptor B2B | Completar tipoContribuyente: "CONTRIBUYENTE" |
| 1303 | Tipo de contribuyente receptor inválido (informado cuando el receptor es NO_CONTRIBUYENTE) | Eliminar tipoContribuyente cuando es B2C no contribuyente |
| 1304 | Falta numeroDocumento (RUC) para receptor contribuyente | Completar el RUC del receptor |
| 1305 | RUC del receptor no requerido (informado para NO_CONTRIBUYENTE) | Eliminar numeroDocumento para B2C no contribuyente |
| 1306 | RUC del receptor inexistente en Marangatu (no registrado en SET) | Confirmar el RUC con tu cliente |
| 1309 | DV del RUC del receptor incorrecto | Verificar digitoVerificador |
Ver el catálogo completo en Rechazos SIFEN.
Próximos pasos
- Volvé a Factura Electrónica para el flujo completo de emisión.
- Si vas a emitir notas de crédito/débito, repasá las restricciones en Nota de Crédito y Nota de Débito.
Factura Electrónica
Guía completa para emitir una Factura Electrónica con datos del receptor B2C o B2B, ítems, condición de pago y ejemplos de request completo.
Consultar Estado de un Documento
Cómo verificar si un documento fue aprobado o rechazado por SIFEN usando el CDC, con la estrategia de polling recomendada.