Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Bloco de código
titleRequest
[
    {
        "channelCode": "ODV",
        "queue": "queueForNewOrderTransaction_ODV",
        "message": {
            "externalNumber": "000130100000087",
            "internalNumber": "bridge0000000120",
            "creationDate": "2024-05-15 19:07:30",
            "terminalCode": "3010",
            "channelCode": "ODV",
            "currencyCode": "PESO ARGENTINO",
            "netAmount": "3495.4",
            "manualDiscountAmount": "0",
            "orderTypeCode": "order",
            "isPaid": true,
            "perceptionAmount": "0",
            "notes": "Orden creada desde POS",
            "erpCode": "",
             "company":"napse",
             "storeCode":"1",
             "storeName":"Tienda 1 - 7.5",
             "party": {
                "person": false,
                "organization": false,
                "identificationType": "DNI",
                "partyContactMethods": {
                    "delivery": {
                        "name": "Facturacion",
                        "erpCode": "",
                        "address": {
                            "firstLine": "Saenz",
                            "secondLine": null,
                            "cityCode": "CABA_009",
                            "stateCode": "CABA",
                            "countryCode": "ARG",
                            "postalCode": null
                        },
                        "emailAddress": "[email protected]",
                        "telephone": {
                            
                        }
                    },
                    "billing": {
                        "name": "Facturacion",
                        "erpCode": "",
                        "address": {
                            "firstLine": "Saenz",
                            "secondLine": null,
                            "cityCode": "CABA_009",
                            "stateCode": "CABA",
                            "countryCode": "ARG",
                            "postalCode": null
                        },
                        "emailAddress": "[email protected]",
                        "telephone": {
                            
                        }
                    }
                },
                "taxCategory": "CF",
                "allPartyContactMethods": [
                "denomination":    {"Rodrigo Gonzalez"
            },
            "codedetail": "35854549_Facturacion",[
                {
        "name": "Facturacion",
                        "partyAddressFirstLine": "Saenz",
                        "partyAddressCityName": "Chacarita",
                        "partyAddressCityCode": "CABA_009",
                        "partyAddressStateName": "CIUDAD AUTONOMA DE BUENOS AIRES",
                        "partyAddressStateCode": "CABA",
                        "partyAddressCountryName": "Argentina",
                        "partyAddressCountryCode": "ARG",
                        "partyEmail": "[email protected]"
                    },
                    {
                        "code": "35854549_Entrega",
                        "name": "Entrega",
                        "partyAddressFirstLine": "Carlos Pellegrini",
                        "partyAddressCityName": "Barracas",
                        "partyAddressCityCode": "CABA_004",
                        "partyAddressStateName": "CIUDAD AUTONOMA DE BUENOS AIRES",
                        "partyAddressStateCode": "CABA",
                        "partyAddressCountryName": "Argentina",
                        "partyAddressCountryCode": "ARG",
                        "partyAddressPostalCode": "1832",
                        "partyEmail": "[email protected]"
                    }
                ],
                "denomination": "Rodrigo Gonzalez"
            },
            "detail": [
                {
                    "storeCode": "1",
                    "locationCode": "DEP1",
                    "itemStock": {
                        "unitsPerSellingUnit": 0,
                        "availableDate": "2024-05-09T08:50:18",
                        "baseCost": 0,
                        "netCost": 0,
                        "itemCost": 0,
                        "looseWeight": false,
                        "gainWeight": false,
                        "itemDepth": 0,
                        "itemWidth": 0,
                        "itemHeight": 0,
                        "itemDiameter": 0,
                        "itemGrossWeight": 0,
                        "itemNetWeight": 0,
                        "itemDrainedWeight": 0
                    },
                    "itemCode": "PEPITOS",
                    "description": "Pepitos",
                    "barcode": "P001",
                    "units": 5,
                    "price": 100,
                    "packagePrice": false,
                    "quantity": 1,
                    "netAmount": 413.22,
                    "extendedPrice": 500,
                    "discountTotal": 0,
                    "discountPromoTotal": 0,
                    "percentIva": 21,
                    "priceIvaAmount": 86.78,
                    "totalInternalTax": 0,
                    "totalPerceptions": 0,
                    "unitOfMeasureCode": "u",
                    "deliveryOrPickup": "delivery",
                    "pickupLocationCode": "1",
                    "pickupInformation": "INFORMACION",
                    "requiredDate": "2024-05-15T19:09:27",
                    "partyContactMethodName": "Facturacion",
                    "taxDetail": [
                        {
                            "taxType": "VAT",
                            "taxableAmount": 413.22,
                            "taxAuthority": "2",
                            "amount": 86.78,
                            "taxablePercentage": 21
                        }
                    ],
                    "priceModifiers": [
                        
                    ],
                    "serializedUnits": [
                        
                    ],
                    "voiding": false,
                    "voidFlag": false
                },
                {
                    "storeCode": "1",
                    "locationCode": "DEP1",
                    "itemStock": {
                        "unitsPerSellingUnit": 0,
                        "availableDate": "2024-05-09T08:50:18",
                        "baseCost": 0,
                        "netCost": 0,
                        "itemCost": 0,
                        "looseWeight": false,
                        "gainWeight": false,
                        "itemDepth": 0,
                        "itemWidth": 0,
                        "itemHeight": 0,
                        "itemDiameter": 0,
                        "itemGrossWeight": 0,
                        "itemNetWeight": 0,
                        "itemDrainedWeight": 0
                    },
                    "itemCode": "PEPITOS",
                    "description": "Pepitos",
                    "barcode": "P002",
                    "units": 10,
                    "price": 545.4,
                    "packagePrice": true,
                    "quantity": 1,
                    "netAmount": 450.75,
                    "extendedPrice": 545.4,
                    "discountTotal": 0,
                    "discountPromoTotal": 0,
                    "percentIva": 21,
                    "priceIvaAmount": 94.65,
                    "totalInternalTax": 0,
                    "totalPerceptions": 0,
                    "unitOfMeasureCode": "u",
                    "deliveryOrPickup": "delivery",
                    "pickupLocationCode": "1",
                    "pickupInformation": "INFORMACION",
                    "requiredDate": "2024-05-15T19:09:27",
                    "merchandiseHierarchyGroup":"Comida",
                    "partyContactMethodName": "Facturacion",
                    "taxDetail": [
                        {
                            "taxType": "VAT",
                            "taxableAmount": 450.75,
                            "taxAuthority": "2",
                            "amount": 94.65,
                            "taxablePercentage": 21
                        }
                    ],
                    "priceModifiers": [
                        
                    ],
                    "serializedUnits": [
                        
                    ],
                    "voiding": false,
                    "voidFlag": false
                },
                {
                    "storeCode": "1",
                    "locationCode": "DEP1",
                    "itemCode": "PESABLEBC",
                    "description": "Artoculo pesable con barcode",
                    "magnitude": 1.5,
                    "units": 1.5,
                    "price": 1000,
                    "packagePrice": false,
                    "quantity": 1,
                    "netAmount": 1239.67,
                    "extendedPrice": 1500,
                    "discountTotal": 0,
                    "discountPromoTotal": 0,
                    "percentIva": 21,
                    "priceIvaAmount": 260.33,
                    "totalInternalTax": 0,
                    "totalPerceptions": 0,
                    "unitOfMeasureCode": "kg",
                    "deliveryOrPickup": "delivery",
                    "pickupLocationCode": "1",
                    "pickupInformation": "INFORMACION",
                    "requiredDate": "2024-05-15T19:09:27",
                    "partyContactMethodName": "Facturacion",
                    "taxDetail": [
                        {
                            "taxType": "VAT",
                            "taxableAmount": 1239.67,
                            "taxAuthority": "2",
                            "amount": 260.33,
                            "taxablePercentage": 21
                        }
                    ],
                    "priceModifiers": [
                        
                    ],
                    "voiding": false,
                    "voidFlag": false
                },
                {
                    "storeCode": "1",
                    "locationCode": "DEP1",
                    "itemCode": "500500",
                    "description": "Galletitas sonrisas x3",
                    "units": 1,
                    "price": 950,
                    "packagePrice": 1false,
                    "pricequantity": 9501,
                    "packagePricebarcode": false"P001",
                    "quantitybarcodeDescription": 1"Galletitas sonrisas x3",
                               "netAmount": 785.12,
                    "extendedPrice": 950,
                    "discountTotal": 0,
                    "discountPromoTotal": 0,
                    "percentIva": 21,
                    "priceIvaAmount": 164.88,
                    "totalInternalTax": 0,
                    "totalPerceptions": 0,
                    "unitOfMeasureCode": "u",
                    "deliveryOrPickup": "delivery",
                    "pickupLocationCode": "1",
                    "pickupInformation": "INFORMACION",
                    "requiredDate": "2024-05-15T19:09:27",
                    "partyContactMethodName": "Facturacion",
                    "taxDetail": [
                        {
                            "taxType": "VAT",
                            "taxableAmount": 785.12,
                            "taxAuthority": "2",
                            "amount": 164.88,
                            "taxablePercentage": 21
                        }
                    ],
                    "priceModifiers": [
                        
                    ],
                    "voiding": false,
                    "voidFlag": false
                }
            ],
            "transactions": [
                {
                    "storeCode": "1",
                    "terminalCode": "3010",
                    "trxNumber": "87",
                    "trxDate": "2024-05-15 19:08:00"
                }
            ],
            "payments": [
                
            ],
            "iva0Amount": 0,
            "iva21Amount": 2888.76,
            "iva105Amount": 0,
            "iva27Amount": 0,
            "iva18Amount": 0,
            "netSalesAmount": 3495.4,
            "grossAmount": "0",
            "taxAmount": "606.64",
            "promoDiscountAmount": "0",
            "globalMargin": 302.3875,
            "operatorCode": "Andre",
            "operatorName": "Andrea Asato",
            "ivaTaxAmount": "0",
            "internalTaxAmount": "0",
            "itemCount": 4
        },
        "sent": true,
        "info": "Se envio con exito"
    }
]

...


CampoTipoDescripciónEjemplos

externalNumberStringCódigo de la orden del originante"externalNumber": "000130100000087",

internalNumberStringNro de pedido interno de BRIDGE"internalNumber": "bridge0000000120",

notesStringComentarios sobre la orden

"notes": "Orden creada desde POS",

Enviar por la tarde


creationDateStringFecha de creación

"creationDate": "2024-05-15 19:07:30",

Formato: yyyy-MM-dd HH:mm:ss

channelCodeStringCanal de Origen

"channelCode": "ODV",

Este código será asignado por Napse de acuerdo al canal.


terminalCodeStringCódigo de la terminal donde se crea el pedido

"terminalCode": "3010",

T125 (a partir de 7.5.5)


companyStringCódigo de la compañía

"company": "napse",

Napse (a partir de 7.5.5)

currencyCodeStringMoneda

"currencyCode": "PESO ARGENTINO",

peso


netAmountNumberMonto final del pedido, incluyendo el costo de entrega, menos los descuentos.

"netAmount": "3495.4",

1000


manualDiscountAmountNumberImporte de descuentos a la transacción

"manualDiscountAmount": "0",

Informar 0 si no existe ninguno

orderTypeCode
StringCódigo del tipo de orden

"orderTypeCode": "order",

Por default: 'web'


isPaid
BooleanIndicador de cobrado"isPaid": true

externalSellerIDStringID del vendedor externo (no es un usuario BRIDGE) 

externalSellerNameStringNombre del vendedor externo (no es un usuario de BRIDGE) 

perceptionAmountNumberMonto de percepciones del pedido 

storeCodeStringCódigo de la tienda

"storeCode": "1",


storeNameStringNombre de la tienda

"storeName": "Tienda 1 - 7.5",


iva0AmountNumberNeto gravado iva del 0%

"iva0Amount": 0,


iva21AmountNumberNeto gravado iva del 21%

"iva21Amount": 2888.76,


iva105AmountNumberNeto gravado iva del 10.5%

"iva105Amount": 0,


iva27AmountNumberNeto gravado iva del 27%

 "iva27Amount": 0,


iva18AmountNumberNeto gravado iva del 18%

 "iva18Amount": 0,


netSalesAmountNumberMonto del pedido 

"netSalesAmount": 3495.4,


grossAmountString

"grossAmount": "0",


taxAmountStringMonto total de impuesto (iva y percepciones) 

"taxAmount": "606.64",


promoDiscountAmountString

"promoDiscountAmount": "0",


globalMarginNumberMargen global del pedido (porcentaje) 

"globalMargin": 302.3875,


operatorCodeStringCódigo del operador que crea el pedido

"operatorCode": "Andre",


operatorNameStringNombre del operador que crea el pedido

"operatorName": "Andrea Asato",


ivaTaxAmountStringMonto del iva acumulado

"ivaTaxAmount": "0",


internalTaxAmountStringMonto de impuestos internos

 "internalTaxAmount": "0",


itemCountNumberCantidad de ítems en el pedido

"itemCount": 4


attachNoteStringNota del pedido (ingresados en el POS) 



perceptionAmountNumberMonto de percepciones (IB e IVA)

"perceptionAmount": "0",

orderReference(orden de referencia). Requerido si la orden es de devolución(orderTypeCode == "return")


externalNumber
StringCódigo de la orden000001
party (cliente asociado a la transacción). Requerido

codeStringCódigo del cliente024314537

taxCategoryStringCategoría impositiva del cliente ante el IVARI (a partir de 7.5.5)

firstNameStringNombre del ClienteMartin

lastNameStringApellido del clienteMalievac

emailStringCorreo del cliente[email protected]

identificationTypeNumberTipo de documento

1, valores posibles:

1: DNI
2: Pasaporte
3: CUIL
4: CUIT

"identificationType": "DNI",


identifierStringNúmero de documento24314537

birthYearNumberNumberAño de nacimiento1975

birthMonthNumberNumberMes de nacimiento3

birthDayNumberNumberDía de nacimiento1

personStringSi es del tipo persona"person": true,

organizationStringSi es del tipo empresa u organización

genderTypeStringSexo del cliente

Valores: M, F, NB

"genderType": "M",


typeCodeStringTipo de cliente

"typeCode": "PRS",


denominationString


partyContactMethods (direcciones del cliente). Requerido

delivery.nameStringNombre del método de contacto

Personal, Trabajo, etc.

Este dato debe ser único, en caso de encontrarse repetido dentro de la lista, se informará:

"No puede realizar un pedido con dos métodos de contacto con el mismo nombreSe informará el método de contacto elegido para envío a domicilio o el que se encuentre definido como "principalForDelivery"


delivery,address.firstLineStringCalle y númeroAlmafuerte 1000

delivery.address.secondLineStringOtra infoPiso 10, Puerta 12

delivery.address.cityCodeStringCiudadMUN. Importante: código del listado de ciudades existentes, ver servicio city/all

delivery.address.stateCodeStringProvinciaBsAs. Importante: código del listado de provincias existentes, ver servicio state/all

delivery.address.countryCodeStringPaisARG. Importante: código del listado de países existentes, ver servicio country/all


delivery.address.postalCodeString


delivery.emailAddressStringEmail asociado a ese método de contactoSe puede poner el principal si no es diferente


billing,address.firstLineStringCalle y númeroAlmafuerte 1000Calle y número

Almafuerte 1000

Se informará el método de contacto elegido como domicilio de facturación o el que se encuentre definido como "principalForBilling"


billing.address.secondLineStringOtra infoPiso 10, Puerta 12


billing.address.cityCodeStringCiudadMUN. Importante: código del listado de ciudades existentes, ver servicio city/all


billing.address.cityNameStringNombre de la ciudad"BUENOS AIRES"


billing.address.stateCodeStringProvinciaBsAs. Importante: código del listado de provincias existentes, ver servicio state/all


billing.address.stateNameStringNombre de la provinciaBUENOS AIRES


billing.address.countryCodeStringPaisARG. Importante: código del listado de países existentes, ver servicio country/all


billing.address.countryNameStringNombre del país


billing.address.postalCodeStringCódigo postal 


billing.emailAddressStringEmail asociado a ese método de contactoSe puede poner el principal si no es diferente


billing.telephone.countryCodeStringcódigo de País54


billing.telephone.areaCodeStringcódigo de area11


billing.telephone.telephoneNumberStringnúmero de teléfono36637777

billing.telephone.countryCodeStringcódigo de País54

billing.telephone.areaCodeStringcódigo de area11

billing.telephone.telephoneNumberStringnúmero de teléfono36637777

extensionNumberStringextensión066

principalForDelivery

Boolean
Opcional: true/false.

En caso de enviar más de una dirección 'marcada' para delivery se va a tomar una sola. Idem para la dirección de facturación.


principalForBillingBoolean
Opcional: true/false.

En caso de enviar más de una dirección 'marcada' para delivery se va a tomar una sola. Idem para la dirección de facturación.


postalCodeStringCódigo postal 

"postalCode": "1323"


erpCodeStringCódigo del ERP 

"erpCode": "",


allPartyContactMethodsArray

Se quita


codeStringCódigo del método de contacto


 "allPartyContactMethods": [
                    {
                        "code": "35854549_Facturacion",
                        "name": "Facturacion",
                        "partyAddressFirstLine": "Saenz",
                        "partyAddressCityName": "Chacarita",
                        "partyAddressCityCode": "CABA_009",
                        "partyAddressStateName": "CIUDAD AUTONOMA DE BUENOS AIRES",
                        "partyAddressStateCode": "CABA",
                        "partyAddressCountryName": "Argentina",
                        "partyAddressCountryCode": "ARG",
                        "partyEmail": "[email protected]"
                    },



nameStringNombre del método de contacto

partyAddressFirstLineStringDirección

partyAddressCityNameStringNombre de la ciudad

partyAddressCityCodeStringCódigo de la ciudad

partyAddressStateNameStringNombre de la provincia o estado

partyAddressStateCodeStringCódigo de la provincia o estado

partyAddressCountryNameStringNombre del país

partyAddressCountryCodeStringCódigo del país

partyEmailStringDirección de mail
detail (Detalle del pedido). Debe haber al menos uno

itemCodeStringSKU del producto"itemCode": "PEPITOS",

descriptionStringDescripción del producto "description": "Pepitos",

quantityNumberCantidad pedida"quantity": 1,

priceNumberPrecio unitario

1000

"price": 100,


packagePriceStringIndica si es precio por paquete o no

"packagePrice": false,


deliveryOrPickupStringSi la linea será con retiro en tienda o envío

 "deliveryOrPickup": "delivery",

delivery o pickup

pickupLocationCodeStringCódigo de la locación en donde retirará

"pickupLocationCode": "1",

UNICENTER. El código debe estar estipulado. Ver servicio customerOrderPickupLocation/all


pickupInformationStringDescripción de quien hará el retiro

"pickupInformation": "INFORMACION",

Juan Perez retirará, teléfono: XXXXX


requiredDateStringFecha de envío requerida o de retiro en tienda

"requiredDate": "2024-05-15T19:09:27",

Formato: yyyy-MM-dd HH:mm:ss


partyContactMethodNameStringDirección de envío del cliente

"partyContactMethodName": "Facturacion",

Personal, debe existir entre una de las direcciones informadas para el cliente


barcodeNumberCódigo de barras del articulo (si fue ingresado con ese dato)

"barcode": "P001",




barcodeDescriptionStringDescripción del código de barras

 "barcodeDescription":"Shampoo Johnson's Baby pH Balanceado x 200 ml",


magnitudeNumberMagnitud (peso, longitud, etc) del item si su  unidad de medida asociada tiene manejo de decimales

"magnitude": 1.5,



unitsStringCantidad de unidades de la presentación (asociado al código de barras) 

 "units": 5,


storeCodeStringCódigo de Tienda 

 "storeCode": "1",


locationCodeStringCódigo del depósito "locationCode": "DEP1",

netAmountNumberMonto neto 

"netAmount": 413.22,


extendedPriceNumber Precio extendido (cantidad x precio - descuentos)

"extendedPrice": 500,


discountTotalNumberMonto total de descuento del item

 "discountTotal": 0,


discountPromoTotalNumberMonto total de descuento por promoción del item

"discountPromoTotal": 0,


percentIvaNumberPorcentaje de iva del item

 "percentIva": 21,


priceIvaAmountNumberMonto de iva del item

 "priceIvaAmount": 86.78,


totalInternalTaxNumberMonto de impuestos internos del item

 "totalInternalTax": 0,


totalPerceptionsNumberMonto de percepciones

"totalPerceptions": 0,


unitOfMeasureCodeStringCódigo de unidad de medida

 "unitOfMeasureCode": "u",


merchandiseHierarchyGroupStringCódigo de la categoría departamental

"merchandiseHierarchyGroup":"pepep",


itemstockObjectDatos de dimensiones del item cuando maneja stock 

"itemStock": {
                        "unitsPerSellingUnit": 0,
                        "availableDate": "2024-05-09T08:50:18",
                        "baseCost": 0,
                        "netCost": 0,
                        "itemCost": 0,
                        "looseWeight": false,
                        "gainWeight": false,
                        "itemDepth": 0,
                        "itemWidth": 0,
                        "itemHeight": 0,
                        "itemDiameter": 0,
                        "itemGrossWeight": 0,
                        "itemNetWeight": 0,
                        "itemDrainedWeight": 0
                    },


taxDetailArrayDetalle de los impuestos (iva e impuestos internos) 

 "taxDetail": [
                        {
                            "taxType": "VAT",
                            "taxableAmount": 413.22,
                            "taxAuthority": "2",
                            "amount": 86.78,
                            "taxablePercentage": 21
                        }
                    ],


voidingStringIndicador del item anulado (esto permite conocer si se debe considerar o no el item) 

"voiding": false,                  


voidFlagStringIndicador del  item que anula (esto permite conocer si se debe considerar o no el item) 

"voidFlag": false

detail.priceModifiers : descuentos otorgados a los productos, esto se encuentra dentro de la colección detail

percentNumberPorcentaje de descuento5

amountNumberMonto de descuento1000

reasonTextStringRazón del descuentoOferta del día
serializedUnits: en caso de que BRIDGE ya haya surtido el pedido en las tiendas, se detallan los números de serie

SerialNumberStringNro de serie del itemRequerido sólo si se envía lista de series

importDocNumberStringNro de despacho

customsNumberStringAduana

customsDateStringFecha de despacho

unitCountNumberCantidad

Requerido sólo si se envía lista de series


transaction: este campo se usa en el caso de que la transacción haya sido facturada en bridge, no se usa en caso de que la orden venga de canales externos.

idStringEl ID de mongodb de la transacción "transactions": [
                {
                    "storeCode": "1",
                    "terminalCode": "3010",
                    "trxNumber": "87",
                    "trxDate": "2024-05-15 19:08:00"
                }
            ],

storeCodeStringEl código de tienda BRIDGE

terminalCodeStringEl código de terminal BRIDGE

operatorCodeStringEl código de operador BRIDGE

trxNumberNumberEl número de transacción BRIDGE

trxDate
Date

La fecha de la transacción BRIDGE

Formato: yyyy-MM-dd HH:mm:ss

payments (pagos asociados al pedido)

tenderStringCódigo del medio de pagopeso. Importante: ver servicio tender/all para los códigos de pago permitidos.

amount:NumberMonto del pago1000

planDescriptorStringDescripción del plan de pagos elegido9 meses sin intereses

sellerNameStringNombre de la entidadMirgor

authorizationCodeStringCodigo de autorización de la tarjeta
  • En el caso de MercadoPago, aqui se informa el id de pago.

couponNumberStringNúmero de cupón1

lotNumberStringNúmero de Lote1

installmentsStringCuotas9

referenceNumberStringReferencia de la tarjeta44444444, en el caso de MercadoPago, allí va el id de la cuenta.

...