Método de envío
SendDocumentToAuthority
Tras validar el documento, API-FLIP construye una respuesta en formato JSON que se retorna al POS originador (Oracle Opera).
Ejemplos
SendDocumentToAuthority (Ex. Paraguay)
{
"DocumentInfo": {
"HotelCode": "LP_PRY",
"BillNo": "213",
"FolioType": "01",
"TerminalId": "Gosocket",
"ProgramName": "",
"FiscalFolioId": "866322",
"OperaFiscalBillNo": "",
"Application": "OPERA_CLOUD",
"PropertyTaxNumber": "801288223",
"BankName": "",
"BankCode": "",
"BankIdType": "",
"BankIdCode": "",
"BusinessDate": "2021-01-23",
"BusinessDateTime": "2021-01-23T12:09:27",
"CountryCode": "PY",
"CountryName": "Paraguay",
"Command": "INVOICE",
"FiscalTimeoutPeriod": ""
},
"AdditionalInfo": {
"BeforeSettlement": {},
"ProfileOptions": {
"NV": [{
"Name": "eInvoice_Address",
"Value": "gaston.otero@oracle.com"
}
]
},
"MappedValues": {
"MappingType": [{
"Type": "FISCAL_CNTRY_CITIES",
"MappedValue": [{
"Code": "ASUNCION",
"Description": "TBD",
"NV": [{
"Name": "MC_GENERIC1",
"Value": "1"
}
]
}
]
}, {
"Type": "FISCAL_COUNTRY_CODES",
"MappedValue": [{
"Code": "PY",
"Description": "TBD",
"NV": [{
"Name": "MC_GENERIC1",
"Value": "PRY"
}
]
}
]
}, {
"Type": "FISCAL_DISTRICT_CODE"
}, {
"Type": "FISCAL_GENDER"
}, {
"Type": "FISCAL_ID_COUNTRY"
}, {
"Type": "FISCAL_ID_TYPES"
}, {
"Type": "FISCAL_MARKET_CODES"
}, {
"Type": "FISCAL_NATIONALITY"
}, {
"Type": "FISCAL_PAYMENT_TYPES"
}, {
"Type": "FISCAL_PROPERTY_CODE"
}, {
"Type": "FISCAL_PURPOSE_VISIT"
}, {
"Type": "FISCAL_ROOM_TYPES"
}, {
"Type": "FISCAL_STATE_CODES"
}, {
"Type": "FISCAL_TRANSPORT"
}, {
"Type": "FISCAL_TRX_CODES"
}
]
},
"ReservationOptions": {}
},
"UserDefinedFields": {
"CharacterUDFs": [{
"UDF": [{
"Name": "FLIP_ACCOUNTING_SUPPLIER_ID"
}, {
"Name": "FLIP_ACCOUNTING_SUPPLIER_SCHEMEID"
}, {
"Name": "FLIP_ACCOUNTING_TAX_ID"
}, {
"Name": "FLIP_ASSOCIATED_FISCAL_BILL_DATE"
}, {
"Name": "FLIP_ASSOCIATED_FISCAL_BILL_NO"
}, {
"Name": "FLIP_ASSOCIATED_FISCAL_BILL_TIME"
}, {
"Name": "FLIP_ASSOCIATED_FISCAL_TERMINAL_ID"
}, {
"Name": "FLIP_CERTIFICATE_NUMBER"
}, {
"Name": "FLIP_CONFIGMODE",
"Value": "DEFAULT"
}, {
"Name": "FLIP_DEPOSIT_TRANSFER"
}, {
"Name": "FLIP_EXTENDED_RESPONSE",
"Value": "YES"
}, {
"Name": "FLIP_FINANCIAL_ACCOUNTING_BANK_CODE"
}, {
"Name": "FLIP_FINANCIAL_ACCOUNTING_ID"
}, {
"Name": "FLIP_FISCAL_DEVICE_PASSWORD"
}, {
"Name": "FLIP_NO_PAYMENT_DESCRIPTION"
}, {
"Name": "FLIP_NO_PAYMENT_SUBTYPE"
}, {
"Name": "FLIP_NO_PAYMENT_TYPE"
}, {
"Name": "FLIP_PARTNER_ARRANGEMENT"
}, {
"Name": "FLIP_PARTNER_BRANCH_CODE"
}, {
"Name": "FLIP_PARTNER_CHARGE_ID"
}, {
"Name": "FLIP_PARTNER_CONTRIBUTOR"
}, {
"Name": "FLIP_PARTNER_EXCLUDE_FB"
}, {
"Name": "FLIP_PARTNER_FISCAL_BILL_NO",
"Value": "Y"
}, {
"Name": "FLIP_PARTNER_FISCAL_INCENTIVE"
}, {
"Name": "FLIP_PARTNER_FOLIO_TEXT"
}, {
"Name": "FLIP_PARTNER_FOLIO_TEXT_1_10"
}, {
"Name": "FLIP_PARTNER_GOODS_FOLIO"
}, {
"Name": "FLIP_PARTNER_IFC_CASHIER"
}, {
"Name": "FLIP_PARTNER_MODE"
}, {
"Name": "FLIP_PARTNER_MULTIPLE_TAXES"
}, {
"Name": "FLIP_PARTNER_NETGROSS"
}, {
"Name": "FLIP_PARTNER_PATTERN"
}, {
"Name": "FLIP_PARTNER_RULE"
}, {
"Name": "FLIP_PARTNER_SERIAL"
}, {
"Name": "FLIP_PARTNER_SERVICES_FOLIO"
}, {
"Name": "FLIP_PARTNER_SPECIAL_TAX"
}, {
"Name": "FLIP_PARTNER_SPECIAL_TAX2"
}, {
"Name": "FLIP_PARTNER_TAX1"
}, {
"Name": "FLIP_PARTNER_TAX2"
}, {
"Name": "FLIP_PARTNER_TAX3"
}, {
"Name": "FLIP_PARTNER_TAX4"
}, {
"Name": "FLIP_PARTNER_TAX5"
}, {
"Name": "FLIP_PARTNER_TAX_LEVEL"
}, {
"Name": "FLIP_PARTNER_TAX_QUALIFICATION",
"Value": "2"
}, {
"Name": "FLIP_PARTNER_TRANSLATION_LANGUAGE"
}, {
"Name": "FLIP_PARTNER_VAT_RATE"
}, {
"Name": "FLIP_PARTNER_VAT_RATE2"
}, {
"Name": "FLIP_PERSON_IN_CHARGE"
}, {
"Name": "FLIP_PROPERTY_ADDRESS1"
}, {
"Name": "FLIP_PROPERTY_ADDRESS2",
"Value": "1"
}, {
"Name": "FLIP_PROPERTY_ADDRESS3",
"Value": "0"
}, {
"Name": "FLIP_PROPERTY_ADDRESS4"
}, {
"Name": "FLIP_PROPERTY_ADDRESS5"
}, {
"Name": "FLIP_PROPERTY_CATALOGUE_ID"
}, {
"Name": "FLIP_PROPERTY_CODE"
}, {
"Name": "FLIP_PROPERTY_COUNTRY"
}, {
"Name": "FLIP_PROPERTY_ECONOMIC_ID",
"Value": "55101"
}, {
"Name": "FLIP_PROPERTY_ID",
"Value": "001"
}, {
"Name": "FLIP_RECEIVER_AUTHORITY"
}, {
"Name": "FLIP_SENDER_AUTHORITY"
}, {
"Name": "FLIP_SERVER_ADDRESS",
"Value": "AP--GOTERO-D8D3JR3."
}, {
"Name": "FLIP_SOFTWARE_NAME"
}, {
"Name": "FLIP_SUPPLIER_CONTACT_EMAIL"
}, {
"Name": "FLIP_SUPPLIER_ENDPOINT_ID"
}, {
"Name": "FLIP_TAX_FREE_PROPERTY"
}, {
"Name": "FLIP_UNIT_CODE"
}
]
}
]
},
"FiscalTerminalInfo": {
"TerminalAddressAndPort": "3912418a-aeb6-440a-bf17-3703b5382f76",
"TerminalID": "Gosocket"
},
"FolioInfo": {
"FolioHeaderInfo": {
"BillGenerationDate": "2021-01-23T12:09:27",
"FolioType": "01",
"CreditBill": false,
"FolioNo": "2207853551",
"BillNo": "213",
"Window": "1",
"CashierNumber": "6",
"FiscalFolioStatus": "OK",
"LocalBillGenerationDate": "2021-01-23T12:09:27",
"CollectingAgentTaxes": {
"AmountUDFsType": {}
},
"FolioTypeUniqueCode": "0"
},
"PayeeInfo": {
"NameId": 2208703958,
"FirstName": "Juanchi",
"LastName": "Baileiron",
"DateOfBirth": "00010101",
"Passport": "",
"Tax1No": "XXXXXXXXX",
"Tax2No": "",
"NameTaxType": "GRA",
"PaymentDueDate": "2021-02-02",
"Nationality": "ARG",
"UserDefinedFields": {},
"IdentificationInfos": {
"IdentificationInfo": [{
"IdType": "4",
"IdNumber": "XXXXXXX",
"Primary": true
}
]
},
"KeywordInfos": {
"KeywordInfo": [{
"KeywordType": "FLASTNAME",
"KeyWord": "HERNANDEZ"
}, {
"KeywordType": "MLASTNAME",
"KeyWord": "PENA"
}
]
},
"Email": "juanchi@lospericos.com",
"Address": {
"Address1": "las camelias",
"Address2": "1134",
"AddresseeCountryDesc": "Paraguay",
"AddresseeStateDesc": "CAPITAL",
"City": "Asuncion",
"Country": "PY",
"District": "1",
"IsoCode": "PY",
"PostalCode": "1173",
"Primary": true,
"State": "1",
"Type": "HOME"
},
"Phone": {
"Number": "212212-1122",
"Type": "HOME"
},
"Language": "E",
"NameType": "INDIVIDUAL",
"TaxCategory": "2",
"FiscalGuestType": "1"
},
"Postings": [{
"TrxNo": 2221558899,
"TrxCode": "9000",
"TrxDate": "2021-01-23",
"TrxType": "FC",
"UnitPrice": 1100.0,
"Quantity": 1.0,
"Currency": "PYG",
"TaxInclusive": false,
"ExchangeRate": 1.0,
"TrxDateTime": "2021-01-23T12:08:38",
"LocalTrxDateTime": "2021-01-23T12:08:38",
"Reference": "",
"GuestAccountCredit": 1100.0,
"TranActionId": 2218077294,
"FinDmlSeqNo": 2213461790,
"ReceiptNumber": "138",
"ReceiptType": "PAR",
"CashierId": "6",
"OrgResvNameId": "2216809599",
"Display": true
}, {
"TrxNo": 2221558970,
"TrxCode": "1000",
"TrxDate": "2021-01-23",
"TrxType": "C",
"UnitPrice": 1000.0,
"Quantity": 1.0,
"Currency": "PYG",
"TaxInclusive": false,
"ExchangeRate": 1.0,
"TrxDateTime": "2021-01-23T12:08:00",
"LocalTrxDateTime": "2021-01-23T12:08:00",
"NetAmount": 1000.0,
"GrossAmount": 1000.0,
"Reference": "",
"GuestAccountDebit": 1000.0,
"TranActionId": 2218077301,
"FinDmlSeqNo": 2213461916,
"CashierId": "6",
"OrgResvNameId": "2216809599",
"Display": true,
"Generates": {
"Generate": [{
"Currency": "PYG",
"ExchangeRate": 1.0,
"LocalTrxDateTime": "2021-01-23T12:08:00",
"Quantity": 1.0,
"TaxInclusive": false,
"TaxRate": 10.0,
"TrxCode": "8500",
"TrxDate": "2021-01-23",
"TrxDateTime": "2021-01-23T12:08:00",
"TrxNo": 2221558972,
"TrxType": "C",
"UnitPrice": 100.0,
"FinDmlSeqNo": 2213461917,
"GrossAmount": 100.0,
"GuestAccountDebit": 100.0,
"NetAmount": 100.0,
"Reference": "[Add: 10%Prices.(B)]",
"TranActionId": 2218077577,
"TrxNoAddedBy": 2221558970,
"CashierId": "6",
"OrgResvNameId": "2216809599",
"Display": true
}
]
}
}, {
"TrxNo": 2221558972,
"TrxCode": "8500",
"TrxDate": "2021-01-23",
"TrxType": "C",
"UnitPrice": 100.0,
"Quantity": 1.0,
"Currency": "PYG",
"TaxInclusive": false,
"ExchangeRate": 1.0,
"TrxDateTime": "2021-01-23T12:08:00",
"LocalTrxDateTime": "2021-01-23T12:08:00",
"NetAmount": 100.0,
"GrossAmount": 100.0,
"TrxNoAddedBy": 2221558970,
"Reference": "[Add: 10%Prices.(B)]",
"GuestAccountDebit": 100.0,
"TranActionId": 2218077577,
"FinDmlSeqNo": 2213461917,
"CashierId": "6",
"OrgResvNameId": "2216809599",
"Display": true
}
],
"RevenueBucketInfo": [{
"BucketCode": "CASH",
"BucketType": "FLIP_PAY_SUBTYPE",
"BucketValue": "1|0|1",
"Description": "Cash Payments",
"BucketCodeTotalGross": 1100.0,
"TrxCode": [
"9000"
],
"BucketCodeTotalNet": 0.0
}, {
"BucketCode": "GROUP_1",
"BucketType": "FLIP_TRX_BY_GRP",
"BucketValue": "2|77",
"Description": "Habitaciones",
"BucketCodeTotalGross": 1000.0,
"TrxCode": [
"1000"
],
"BucketCodeTotalNet": 1000.0
}, {
"BucketCode": "TAX_1",
"BucketType": "FLIP_TAX_CODES",
"BucketValue": "1|1",
"Description": "Iva 10%",
"BucketCodeTotalGross": 100.0,
"TrxCode": [
"8500"
],
"BucketCodeTotalNet": 100.0
}
],
"TotalInfo": {
"NetAmount": 1000.0,
"GrossAmount": 1100.0,
"NonTaxableAmount": 0.0,
"PaidOut": 0.0,
"Taxes": {
"Tax": [{
"Name": "1",
"Value": 100.0,
"NetAmount": 1000.0,
"Percent": "10.00",
"Amount": ""
}
]
}
},
"TrxInfo": [{
"HotelCode": "LP_PRY",
"Group": "ROOM",
"SubGroup": "ROOM",
"Code": "1000",
"TrxType": "C",
"Description": "Accommodation - Tax Inclusive",
"Articles": {},
"TranslatedDescriptions": {},
"TrxCodeType": "L"
}, {
"HotelCode": "LP_PRY",
"Group": "TAX",
"SubGroup": "TAX",
"Code": "8500",
"TrxType": "C",
"TaxCodeNo": 1,
"Description": "Iva 10%",
"Articles": {},
"TranslatedDescriptions": {},
"TrxCodeType": "X"
}, {
"HotelCode": "LP_PRY",
"Group": "PAYMENT",
"SubGroup": "CASH",
"Code": "9000",
"TrxType": "FC",
"Description": "Cash",
"Articles": {},
"TranslatedDescriptions": {}
}
]
},
"HotelInfo": {
"HotelCode": "LP_PRY",
"HotelName": "OPERA Cloud Paraguay Property - LP",
"LegalOwner": "AMAPOLA SA",
"Address": {
"Address": "Los alerces 1000",
"AddresseeStateDesc": "CAPITAL",
"City": "Asuncion",
"Country": "PY",
"PostalCode": "1173",
"State": "1"
},
"LocalCurrency": "PYG",
"Decimals": "0",
"PhoneNo": "290-4567",
"Email": "hoteles@paraguay.com",
"ExchangeRates": {},
"PropertyDateTime": "2026-03-11T12:09:27"
},
"ReservationInfo": {
"ConfirmationNo": "2210889318",
"ResvNameID": "2216809599",
"ArrivalDate": "2021-01-23",
"ArrivalTime": "12:06:36",
"NumberOfNights": "1",
"DepartureDate": "2021-01-24",
"NumAdults": "1",
"NumChilds": "0",
"GuestInfo": {
"NameId": 2208703958,
"FirstName": "Juanchi",
"LastName": "Baileiron",
"DateOfBirth": "00010101",
"Passport": "",
"Tax1No": "XXXXXXXXX",
"Tax2No": "",
"NameTaxType": "GRA",
"PaymentDueDate": "2021-02-02",
"Nationality": "ARG",
"UserDefinedFields": {},
"IdentificationInfos": {
"IdentificationInfo": [{
"IdType": "4",
"IdNumber": "XXXXXXX",
"Primary": true
}
]
},
"KeywordInfos": {
"KeywordInfo": [{
"KeywordType": "FLASTNAME",
"KeyWord": "HERNANDEZ"
}, {
"KeywordType": "MLASTNAME",
"KeyWord": "PENA"
}
]
},
"Email": "juanchi@lospericos.com",
"Address": {
"Address1": "las camelias",
"Address2": "1134",
"AddresseeCountryDesc": "Paraguay",
"AddresseeStateDesc": "CAPITAL",
"City": "Asuncion",
"Country": "PY",
"District": "1",
"IsoCode": "PY",
"PostalCode": "1173",
"Primary": true,
"State": "1",
"Type": "HOME"
},
"Phone": {
"Number": "212212-1122",
"Type": "HOME"
},
"TaxCategory": "2",
"FiscalGuestType": "1"
},
"NameTaxType": "GRA",
"RoomRate": 3000.0,
"StayTotal": 3300.0,
"RatePlanCode": "BKFINC",
"RoomNumber": "1003",
"RoomClass": "ALL",
"RoomType": "SINGLE",
"NumberOfRooms": "1",
"Guarantee": "CHECKED IN",
"MarketCode": "DAY",
"ResStatus": "CHECKED IN",
"UserDefinedFields": {},
"SourceCode": "IND",
"SourceGroup": "ALL"
},
"FiscalFolioUserInfo": {
"AppUser": "GOTLPFISCAL@OLPFISCA",
"AppUserId": "141729",
"EmployeeNumber": "",
"CashierId": "6",
"CashierName": "Gaston Otero"
},
"VersionInfo": {
"PayloadVersion": "00137",
"ApplicationPath": "",
"OPERACloud": {
"OPERACloudVersion": "26.2.0.0",
"Major": 26,
"Minor": 2,
"Patch": 0,
"Patchset": 0
}
},
"FiscalPartnerResponse": {
"FiscalResponse": {}
}
}Campos de la respuesta
| Campo | Descripción |
|---|---|
status | Estado de la operación: AUTHORIZED o ERROR. |
folio | Folio fiscal asignado al documento. |
authorizationDate | Fecha de autorización del documento. |
fiscalId | Identificador fiscal del documento (UUID / CAE / TrackID, según el país). |
message | Mensaje descriptivo de aceptación u observaciones encontradas, según el ente fiscal. |
info
La respuesta también puede incluir el código tributario correspondiente, según las reglas de cada país.