Recipient

Datos del receptor de un documento.

En general no se instancia directo: se usan los constructores Recipient.person, Recipient.entity, Recipient.foreign, Recipient.notNominated, Recipient.government, Recipient.diplomatic o Recipient.fromClientId.

Constructors

Constructor

new Recipient(options): Recipient;

Parameters

Parameter	Type
options	RecipientOptions

Returns

Recipient

Properties

clientType

readonly clientType: 
  | "person"
  | "entity"
  | "foreign_entity"
  | "not_nominated"
  | "diplomatic"
  | "government";

---

ruc

readonly ruc: string;

---

socialName

readonly socialName: string;

---

fantasyName

readonly fantasyName: string | undefined;

---

isTaxPayer

readonly isTaxPayer: boolean;

---

countryCode

readonly countryCode: string;

---

city

readonly city: City | undefined;

---

address

readonly address: string | undefined;

---

houseNumber

readonly houseNumber: number | undefined;

---

email

readonly email: string | undefined;

---

phone

readonly phone: string | undefined;

---

code

readonly code: string | undefined;

---

clientId

readonly clientId: number | undefined;

---

extra

readonly extra: {
[key: string]: unknown;
};

Index Signature

[key: string]: unknown

Methods

person()

static person(options): Recipient;

Una persona física.

ruc es el RUC con dígito verificador, o la cédula si no es contribuyente.

Parameters

Parameter	Type
options	RecipientCommon & { ruc: string; name: string; isTaxPayer?: boolean; }

Returns

Recipient

---

entity()

static entity(options): Recipient;

Una empresa o entidad con RUC.

Parameters

Parameter	Type
options	RecipientCommon & { ruc: string; socialName: string; isTaxPayer?: boolean; }

Returns

Recipient

---

foreign()

static foreign(options): Recipient;

Un cliente del exterior.

Es el único tipo que puede llevar dirección sin códigos geográficos paraguayos.

Parameters

Parameter	Type
options	RecipientCommon & { name: string; countryCode: string; documentNumber?: string; }

Returns

Recipient

---

notNominated()

static notNominated(options?): Recipient;

Venta sin identificar al comprador.

Es la factura innominada del mostrador. Se puede nominar después con sd.invoices.nominate(id, clientId).

Parameters

Parameter	Type
options	RecipientCommon

Returns

Recipient

---

government()

static government(options): Recipient;

Un organismo del Estado.

Parameters

Parameter	Type
options	RecipientCommon & { ruc: string; socialName: string; }

Returns

Recipient

---

diplomatic()

static diplomatic(options): Recipient;

Una misión diplomática con exoneración fiscal.

Parameters

Parameter	Type
options	RecipientCommon & { ruc: string; socialName: string; }

Returns

Recipient

---

fromClientId()

static fromClientId(clientId, options): Recipient;

Un cliente ya cargado en SmartDoc, por su id.

Igual hay que dar los datos que van impresos en el documento; el id sirve para que SmartDoc lo asocie a su ficha.

Parameters

Parameter	Type
clientId	number
options	RecipientOptions

Returns

Recipient

---

toApi()

toApi(): {
[key: string]: unknown;
};

Los campos client* que espera la API.

Returns

{
[key: string]: unknown;
}

---

validateFor()

validateFor(allowedTypes): void;

Verifica que este tipo de receptor sirva para el documento.

Los recibos, por ejemplo, aceptan solo persona, entidad y extranjero.

Parameters

Parameter	Type
allowedTypes	ReadonlySet< | "person" | "entity" | "foreign_entity" | "not_nominated" | "diplomatic" | "government">

Returns

void