Skip to main content

The Spanish version is the authoritative reference. View in Spanish

Nomination event

Nomination Event is the action of assigning a receiver to a previously selected electronic invoice using the selection checkboxes from the issued documents inbox.

To start a request for this method, take the following criteria into account:

ChangeDocumentStatus for nomination (request)
ParameterParameter typeData typeDescriptionAllowed valuesLength
countryDocumentIdStringNumericCountry-level tax identifier of the document, also known as CUFE, CLAVE, UUID, IDSee the Country Document ID Structure table44 characters
status*IntegerNumericCode of the event to generate.341-2 characters
descriptionStringAlphanumericReason for the nomination.Example: Authorized5-500 characters
receiverType*StringNumericNature of the receiver.Examples: Taxpayer: 1 Non-taxpayer: 21 character
operationType*StringNumericType of transaction.1: B2B 2: B2C 4: B2F1 character
receiverCountry*StringAlphanumericReceiver's country code.According to the Country Coding XSD3 characters
receiverDocumentType*StringNumericReceiver's identity document type. This field is required when receiverType = 21: Paraguayan ID card 2: Passport 3: Foreign ID card 4: Residency card 5: Diplomatic tax exemption card 9: Other1 character
receiverCode*StringAlphanumericThis field is required when receiverType = 2Identity document number.1-20 characters
receiverName*StringAlphanumericName or business name of the DTE receiver.4-255 characters
receiverTypeTaxpayerStringNumericType of receiving taxpayer. This field is required when receiverType = 11: Natural Person 2: Legal Entity1 character
receiverCodeStringAlphanumericThis field is required when receiverType = 1Receiver's RUC2-8 characters
receiverCodeDVStringNumericThis field is required when receiverType = 1Check digit of the receiver's RUC1 character
receiverFantasyNameStringAlphanumericTrade name.4-255 characters
receiverAddressStringAlphanumericReceiver's address1-255 characters
receiverHouseNumberStringNumericThis field is required when receiverAddress is providedReceiver's house number.1-6 characters
receiverDepartmentCodeStringNumericReceiver's department code.According to the Departments XSD1-2 characters
receiverDepartmentNameStringAlphanumericDescription of the receiver's department.Corresponding to receiverDepartmentCode6-16 characters
receiverDistrictCodeStringNumericReceiver's district code.1-4 characters
receiverDistrictNameStringAlphanumericDescription of the receiver's district.This field is required when receiverDistrictCode is provided1-30 characters
receiverCityCodeStringNumericReceiver's city code.1-5 characters
receiverCityNameStringAlphanumericDescription of the receiver's city.Corresponding to receiverDepartmentCode1-30 characters
receiverPhoneStringNumericReceiver's phone number.Must include the city prefix if receiverDepartmentCode = PRY6-15 characters
receiverCellPhoneStringAlphanumericReceiver's mobile number.10-20 characters
receiverEmailStringAlphanumericReceiver's email address.3-15 characters
customerCodeStringAlphanumericCustomer code.3-80 characters

*Required

*Required


Request example

image-20240502-183521.png

Note: Remember that before using the method, you must authenticate within the Authorization tab.

For this method we use the Params tab in Postman.

  1. Select the method type. In this case, you must select POST.
  2. Enter the method URL.
  3. Enter the parameters shown in the table above with their corresponding values.
  4. Click Send.

Response example

image-20240502-183712.png