...
Bloco de código | ||
---|---|---|
| ||
{ "externalNumber": "00001", "notesid": "5f19d8989eefbe5418406887", "creationDatecompanyCode": "2020-07-01 08:51:00Napse", "channelCodestoreCode": "webunicenter", "currencyCodeterminalCode": "peso20", "netAmountoperatorCode": 3000"martinm", "manualDiscountAmountoperatorName": 0, "party": { "code"Martin Malievac", "trxNumber": "0243145377"4, "firstNametrxDate": "Martin2020-07-10 00:00:00", "lastNametrxType": "Malievacsale", "emailcreationDate": "[email protected]2020-07-01 08:51:00", "typeCodecancelFlag": "Personfalse", "identificationTypechannelCode": 1"bridge", "identifiercurrencyCode": "24314537peso", "birthYearNumbernetAmount": 19754950, "birthMonthNumbermanualDiscountAmount": 10, "internalTaxesTotal": 0, "birthDayNumberivaTotal": 30, "partyContactMethodsotherTaxes": 0, { "deliveryitemsQuantity": {1, "namebillType": "PersonalFC", "addressserieOfficialBill": { "B", "firstLinefiscalPosNumber": "Almafuerte 44300010", "secondLinedocNumber": "Puerta 10, Piso 2123025", "cityCodefiscalCAENumber": "MUN3210", "stateCodefiscalCAEDate": "BsAs"2020-07-10 00:00:00", "countryCodefiscalInvoiceType": "AR"6, "postalCodetotal": 4950, "1605relatedTaxes" }, "emailAddress": "[email protected]", "telephone": { "countryCode": "54", "areaCode": "11", "telephoneNumber": "36637487", "extensionNumber": "-" } }, "billing": { "name": "Trabajo", "address": { "firstLine": "Venezuela 3158", "secondLine": "Piso 6. Interno 066", "cityCode": "VMA", "stateCode": "BsAs", "countryCode": "AR", "postalCode": "1603" }, "emailAddress": "[email protected]", "telephone": { "countryCode": "54", "areaCode": "11", "telephoneNumber": "41100000", "extensionNumber": "066" } } } }, "detail": [ { "itemCode": "ABC001", "description": "SAMSUNG S10", "store": "UNICENTER", "location": "ventas2", "orderedQty": 1, "unitPrice": 1000, "netAmount": 1000, "deliveryOrPickup": "delivery", "deliveryCompany": "Andreani", "packageId": "12345670A", "pickupLocationCode": "-", "requiredDate": "2020-07-10 00:00:00", "partyContactMethodName": "Personal", "serializedUnits": [ { "serialNumber": "123456789", "importDocNumber": "12345", "customsNumber": "123455:[ { "amount":100.66, "baseAmount":479.34, "code":21, "name":"IVA 21%" } ], "otherTaxes": [ { "amount":0, "baseAmount":0, "code":"", "name":"", "aliquot":0, } "party": { "code": "0243145377", "firstName": "Martin", "lastName": "Malievac", "email": "[email protected]", "typeCode": "Person", "identificationType": 1, "identifier": "24314537", "birthYearNumber": 1975, "birthMonthNumber": 1, "birthDayNumber": 3, "taxCategory": "CF", "partyContactMethods": { "delivery": { "name": "Personal", "address": { "firstLine": "Almafuerte 4430", "secondLine": "Puerta 10, Piso 2", "cityCode": "MUN", "stateCode": "BsAs", "countryCode": "AR", "postalCode": "1605" }, "emailAddress": "[email protected]", "telephone": { "countryCode": "54", "areaCode": "11", "telephoneNumber": "36637487", "extensionNumber": "-" } }, "billing": { "name": "Trabajo", "address": { "firstLine": "Venezuela 3158", "customsDatesecondLine": "2020-07-10 00:00:00Piso 6. Interno 066", "unitCountcityCode": 1 }"VMA", { "serialNumberstateCode": "22222222BsAs", "importDocNumbercountryCode": "33333AR", "customsNumberpostalCode": "44444"1603" }, "customsDateemailAddress": "2020-07-10 00:00:00[email protected]", "unitCounttelephone": 1{ }, ], "priceModifiers": [ { "countryCode": "54", "percentareaCode": 5"11", "amounttelephoneNumber": 50"41100000", "reasonTextextensionNumber": "Segunda Unidad066" } ]} } }, "detail": [ { "itemCodeinternaltemCode": "S20ABC001", "description": "SAMSUNGProducto S20Galaxy S2", "storestoreCode": "WEBUNICENTER", "location": "ventas2", "orderedQtyquantity": 21, "unitPriceactualUnitPrice": 20001000, "netAmount": 20001000, "deliveryOrPickupdiscountPromoTotal": "pickup"10, "discountTotal": 10, "deliveryCompanyinternalTaxesTotal": "-"0, "pickupLocationCodeivaTotal": "Unicenter"0, "requiredDateseller": "2020-07-10 00:00:00martinm", "pickupInformationpartyContactMethodName": "Retira por la tarde, luego de las 6." } ], "transaction": { "idPersonal", "serializedUnits": [ { "serialNumber": "5f19d8989eefbe5418406887123456789", "storeCodeimportDocNumber": "unicenter12345", "terminalCodecustomsNumber": "20123455", "operatorCodecustomsDate": "martinm", "trxNumber": 4, "trxDate": "2020-2020-07-10 00:00:00", }, "paymentsunitCount": [1 {}, "tender": "peso"], "amountpriceModifiers": 2000[ }, { "tenderpercent": "VI"5, "amount": 295050, "planDescriptorreasonText": "9Promo mesescliente sin intereses",especial" } "sellerName": "MIRGOR"] }, ], "authorizationCodepayments": "1",[ { "couponNumbertender": "1peso", "lotNumberamount": "1"2000 }, { "tender": "VI", "amount": 2950, "installmentsplanDescriptor": "9 meses sin intereses", "referenceNumbersellerName": "1MIRGOR", } ] }"authorizationCode": "1", "couponNumber": "1", "lotNumber": "1", "installments": "9", "referenceNumber": "1" } ] } |
Descripción de los campos:
Importante: los campos que poseen este ícono , son valores tipificados que deben respetar los valores expuestos por BRIDGE en sus servicios.
Campo | Tipo | Descripción | Requerido | Ejemplos | Validación (código) | |
---|---|---|---|---|---|---|
externalNumber | String | Código de la |
transacción originante | SI | 000001 | 991: el código |
es requerido. 996: Ya existe el código |
originante |
1, valores posibles:
1: DNI
2: Pasaporte
3: CUIL
4: CUIT
trxDate
- En el caso de MercadoPago, aqui se informa el id de pago.
id | String |
El ID de mongodb de la transacción | SI | |||||
companyCode | String | El código de compañia BRIDGE | NO | |||
storeCode | String | El código de tienda BRIDGE | SI | |||
terminalCode | String | El código de terminal BRIDGE | SI | |||
operatorCode | String | El código de operador BRIDGE | SI | |||
operatorName | String | Nombre del operador | NO | Martin Malievac | ||
trxNumber | Number | El número de transacción BRIDGE | SI | |||
trxDate | Date | La fecha de la transacción BRIDGE | SI | Formato: yyyy-MM-dd HH:mm:ss | ||
trxType | String | Tipo de operacion | SI | Valores posibles: sale, refund, exchange | ||
creationDate | String | Fecha de creación | SI | 2020-07-01 08:51:00 Formato: yyyy-MM-dd HH:mm:ss | 992: la fecha de creación es requerida. | |
cancelFlag | String | Indicador si fue cancelada o no | SI | default: false | ||
channelCode | String | Canal de Origen | NO | este código será asignado por Napse de acuerdo al canal. | ||
currencyCode | String | Moneda | SI | peso | 994: la moneda es requerida. | |
netAmount | Number | Monto final de la transacción restando descuentos | SI | 1000 | 995: el monto final es requerido. | |
manualDiscountAmount | Number | Importe de descuentos a la transacción | SI | Informar 0 si no existe ninguno | ||
discountPromoTotal | Number | Importe de promociones de la transacción | SI | Importe de descuentos a la transacción | ||
internalTaxesTotal | Number | Monto de impuestos internos | NO | |||
ivaTotal | Number | Monto de iva | SI | |||
otherTaxes | Number | Monto de otros impuestos (ej: percepciones) | NO | |||
itemsQuantity | Number | Cantidad de unidades de la operación | SI | |||
billType | String | Tipo de comprobante | SI | |||
serieOfficialBill | String | Letra del comprobante | NO | |||
fiscalPosNumber | String | Nro de centro emisor o punto de venta | SI | |||
docNumber | String | Nro del comprobante | SI | |||
fiscalCAENumber | String | Nro de CAE o CAEA | NO | |||
fiscalCAEDate | Date | Fecha de CAE | NO | |||
fiscalInvoiceType | Number | Tipo de comprobante fiscal | NO | |||
total | Number | Monto total del comprobante | SI | |||
relatedTaxes (iva de la transacción) - requerido | ||||||
amount | Number | Importe liquidado según la alícuota de IVA | SI | |||
baseAmount | Number | Base imponible para la determinación de la alícuota | SI | |||
code | String | Código del Tipo de IVA | SI | 0, 21, 27, 10.5 | ||
name | String | Descripción del impuesto | SI | iva 21% | ||
OtherTaxes (otros impuestos de la transacción) - opcional, si se informa sus campos son mandatorios | ||||||
amount | Number | Importe del impuesto | SI | |||
baseAmount | Number | Base imponible para la determinación del tributo | SI | |||
code | String | Código del Tipo de Impuesto | SI | |||
name | String | Descripción de impuesto | SI | |||
aliquot | Number | Alícuota | SI | |||
party (cliente asociado a la transacción) - opcional | ||||||
code | String | Código del cliente | SI | 024314537 | 997: el código del cliente es requerido. | |
firstName | String | Nombre del Cliente | SI | Martin | 997: el nombre de la persona o empresa, es requerido. | |
lastName | String | Apellido del cliente | SI (solo si es typeCode = 'Person') | Malievac | 997: el apellido es requerido para clientes de tipo "Person" | |
String | Correo del cliente | SI | [email protected] | 997: el correo electrónico es requerido. | ||
identificationType | Number | Tipo de documento | SI | 1, valores posibles: 1: DNI | 997: el tipo de identificación es requerido. | |
identifier | String | Número de documento | SI | 24314537 | 997: el número de identificación es requerido. | |
birthYearNumber | Number | Año de nacimiento | NO | 1975 | ||
birthMonthNumber | Number | Mes de nacimiento | NO | 3 | ||
birthDayNumber | Number | Día de nacimiento | NO | 1 | ||
taxCategory | String | Categoría impositiva | SI | MT: MONOTRIBUTISTA
RI: RESPONSABLE INSCRIPTO
CF: CONSUMIDOR FINAL
EX: IVA EXENTO | ||
partyContactMethods (direcciones del cliente). Son requeridas cuando se informa un cliente | ||||||
name | String | Nombre del método de contacto | SI | Personal, Trabajo, etc. | 1002: el nombre del método de contacto es requerido. | |
address.firstLine | String | Calle y número | SI | Almafuerte 1000 | 1003: la dirección es requerida. | |
address.secondLine | String | Otra info | NO | Piso 10, Puerta 12 | ||
address.cityCode | String | Ciudad | SI | MUN. Importante: código del listado de ciudades existentes, ver servicio city/all | 1004: la ciudad es requerida. | |
address.stateCode | String | Provincia | SI | BsAs. Importante: código del listado de provincias existentes, ver servicio state/all | 1005: la provincia es requerida. | |
address.countryCode | String | Pais | SI | ARG. Importante: código del listado de países existentes, ver servicio country/all | 1006: el país es requerido. | |
emailAddress | String | Email asociado a ese método de contacto | SI | Se puede poner el principal si no es diferente | 1007: el correo electrónico en el método de contacto, es requerido. | |
telephone.countryCode | String | código de País | NO | 54 | 1008: el código de país del teléfono es requerido. | |
telephone.areaCode | String | código de area | NO | 11 | 1009: el código de área del teléfono es requerido. | |
telephone.telephoneNumber | String | número de teléfono | SI | 36637777 | 1010: el número de teléfono es requerido. | |
extensionNumber | String | extensión | NO | 066 | ||
detail (Detalle de la transacción). Debe haber al menos uno | ||||||
internalItemCode | String | SKU del producto | SI | SAM01 | 1011: el código del producto es requerido. | |
storeCode | String | Código de tienda desde donde saldrá el stock. | SI | UNICENTER | 1012: el código de tienda del stock es requerido. | |
location | String | Código de depósito desde donde saldrá el stock | NO | VENTAS2 | Si no se informa, toma el default del ítem. | |
description | String | Descripción del producto | SI | Producto Galaxy S2 | 1013: la descripción del producto es requerida. | |
quantity | Number | Cantidad | SI | 1 | 1014: la cantidad pedida es obligatoria. | |
actualUnitPrice | Number | Precio unitario | SI | 1000 | 1015: el precio unitario es requerido. | |
discountPromoTotal | Number | Monto total de descuento por promoción | NO | 100 | ||
discountTotal | Number | Monto total de descuentos manuales | NO | 100 | ||
internalTaxesTotal | Number | Monto de impuesos internos | SI | 0 | ||
ivaTotal | Number | Monto del iva | SI | 0 | ||
extendedPrice | Number | Precio extendido (cantidad por precio unitario menos los descuentos) | SI | 900 | ||
seller | String | Código del vendedor | NO | martinm | ||
partyContactMethodName | String | Dirección de envío del cliente | SI (si eligió como opción delivery) | Personal, debe existir entre una de las direcciones informadas para el cliente | 1019: el nombre de la dirección de envío al cliente es inválido. | |
serializedUnits: en caso de que los items requieran nro de serie, se detallan los mismos - opcional | ||||||
SerialNumber | String | |||||
importDocNumber | String | |||||
customsNumber | String | |||||
customsDate | String | |||||
unitCount | Number | |||||
retail.priceModifiers : descuentos otorgados a los productos, esto se encuentra dentro de la colección item - opcional | ||||||
percent | Number | Porcentaje de descuento | SI (si es informada la línea) | 5 | 1020: si informa un descuento, debe informar el porcentaje. | |
amount | Number | Monto de descuento | SI (si es informada la línea) | 1000 | 1021: si informa un descuento, debe informar el monto. | |
reasonText | String | Razón del descuento | SI | Oferta del día | 1022: si informa descuento, debe informar la razón. | |
payments (pagos asociados a la transacción) A menos uno es requerido | ||||||
tender | String | Código del medio de pago | SI | peso. Importante: ver servicio tender/all para los códigos de pago permitidos. | 1022: debe informar un medio de pago válido. | |
amount: | Number | Monto del pago | SI | 1000 | 1022: debe informar el monto del pago. | |
planDescriptor | String | Descripción del plan de pagos elegido | SI (para pagos con tarjeta) | 9 meses sin intereses |
1023: debe informar |
el plan de |
pagos. |
sellerName | String |
Nombre de la |
entidad | SI (para pagos con tarjeta) |
Respuesta del servicio:
Bloco de código |
---|
{
"ack": 0,
"message": "-",
"internalNumber": "0000001"
} |
- ack es el código de respuesta, en caso de ser un error, mirar tabla a continuación.
- message: descripción del error en caso de existir.
- internalNumber: en caso de haberse creado con éxito, el número de orden asignado por Bridge.
Mirgor | 1024: debe informar el nombre del merchant. | |||||
authorizationCode | String | Codigo de autorización de la tarjeta | SI (para pagos con tarjeta) |
| 1025: debe informar el código de autorización de la tarjeta. | |
couponNumber | String | Número de cupón | SI (para pagos con tarjeta) | 1 | 1026: debe informar el número de cupón | |
lotNumber | String | Número de Lote | SI (para pagos con tarjeta) | 1 | 1027: debe informar número de lote. | |
installments | String | Cuotas | SI (para pagos con tarjeta) | 9 | 1028: debe informar la cantidad de cuotas. | |
referenceNumber | String | Referencia de la tarjeta | SI (para pagos con tarjeta) | 44444444, en el caso de MercadoPago, allí va el id de la cuenta. | 1029: debe informar código de referencia de la tarjeta. |