DBA Data[Home] [Help]

PACKAGE: APPS.AR_GTA_REPORTS_PKG

Source


1 PACKAGE AR_GTA_REPORTS_PKG AUTHID CURRENT_USER AS
2 --$Header: ARGRREPS.pls 120.0.12010000.3 2010/01/19 08:38:42 choli noship $
3 --+=======================================================================+
4 --|               Copyright (c) 2005 Oracle Corporation                   |
5 --|                       Redwood Shores, CA, USA                         |
6 --|                         All rights reserved.                          |
7 --+=======================================================================+
8 --| FILENAME                                                              |
9 --|      ARRREPS.pls                                                     |
10 --|                                                                       |
11 --| DESCRIPTION                                                           |
12 --|      This package is used to generate Golden Tax Adaptor reports      |
13 --|                                                                       |
14 --| HISTORY                                                               |
15 --|     05/08/05          Qiang Li         Created                        |
16 --|     05/17/05          Donghai Wang     Add procedures:                |
17 --|                                            Compare_Header             |
18 --|                                            Compare_Lines              |
19 --|                                            Get_Unmatched_Lines        |
20 --|                                            Generate_Discrepancy_Xml   |
21 --|                                            Generate_Discrepancy_Rep   |
22 --|    09/27/05           Qiang Li         Add function:                  |
23 --|                                            Get_Gt_Tax_Reg_Count       |
24 --|    05/12/05           Qiang Li        Update Generate_Mapping_Rep     |
25 --|                                       Update Get_Gt_Trx               |
26 --|                                       Update Get_Ar_Trx               |
27 --|                                       Rename Get_Gt_Tax_Reg_Count to  |
28 --|                                       Get_Gt_Count                    |
29 --|    07/02/06           Qiang Li        Update FUNCTION Get_Ar_Trx     |
30 --|    06/18/07           Donghai Wang    Update G_MODULE_PREFIX to follow|
31 --|                                       FND log Standards               |
32 --|    25-Jul-2009        Allen Yang      Add functions and procedure:    |
33 --|                                            Get_Consolidation_Trx      |
34 --|                                            Get_Consolidated_Trxs      |
35 --|                                            Generate_Consol_Mapping_Rep|
36 --|                                       for bug 8605196: ENHANCEMENT FOR|
37 --|                                       GOLDEN TAX ADAPTER R12.1.2      |
38 --+======================================================================*/
39 
40 --Declare global variable for package name
41 G_MODULE_PREFIX VARCHAR2(50) :='ar.plsql.AR_GTA_REPORTS_PKG';
42 --==========================================================================
43 --  FUNCTION NAME:
44 --
45 --    Get_Gt_Count                        Public
46 --
47 --  DESCRIPTION:
48 --
49 --    This function get GT trxs count in a given
50 --    AR transaction
51 --  PARAMETERS:
52 --      In:  p_ar_trx_header_id        AR transaction header id
53 --           p_fp_tax_reg_num          first party tax registration number
54 --           P_Gt_Inv_Date_From        Golden Tax Invoice Date from
55 --           P_Gt_Inv_Date_To          Golden Tax Invoice Date to
56 --           P_Gt_Inv_Num_From         Golden Tax Invoice Number from
57 --           P_Gt_Inv_Num_To	         Golden Tax Invoice Number to
58 --     Out:
59 --
60 --  Return: VARCHAR2
61 --
62 --
63 --  DESIGN REFERENCES:
64 --      GTA_REPORTS_TD.doc
65 --
66 --  CHANGE HISTORY:
67 --
68 --           27-Sep-05   	Qiang Li        Created.
69 --           05-Dec-05    Qiang Li        Rename to get_gt_count
70 --                                        Add four new parameters
71 --
72 --===========================================================================
73 FUNCTION Get_Gt_Count
74 ( p_ar_trx_header_id IN NUMBER
75 , p_fp_tax_reg_num   IN VARCHAR2
76 , P_Gt_Inv_Date_From IN DATE
77 , P_Gt_Inv_Date_To   IN DATE
78 , P_Gt_Inv_Num_From  IN VARCHAR2
79 , P_Gt_Inv_Num_To	   IN VARCHAR2
80 )
81 RETURN VARCHAR2;
82 
83 --==========================================================================
84 --  FUNCTION NAME:
85 --
86 --    Get_Ar_Trx                        Public
87 --
88 --  DESCRIPTION:
89 --
90 --    This function get xml data of AR transaction.
91 --
92 --  PARAMETERS:
93 --      In:  p_org_id                  Operating unit id
94 --           p_ar_trx_header_id        AR transaction header id
95 --           p_fp_tax_reg_num          first party tax registration number
96 --           P_Gt_Inv_Date_From        Golden Tax Invoice Date from
97 --           P_Gt_Inv_Date_To          Golden Tax Invoice Date to
98 --           P_Gt_Inv_Num_From         Golden Tax Invoice Number from
99 --           P_Gt_Inv_Num_To	         Golden Tax Invoice Number to
100 --     Out:
101 --
102 --  Return: XMLTYPE
103 --
104 --
105 --  DESIGN REFERENCES:
106 --      GTA_REPORTS_TD.doc
107 --
108 --  CHANGE HISTORY:
109 --
110 --           05/08/05   	Qiang Li        Created.
111 --           09/27/05     Qiang Li        Add new parameter p_fp_tax_reg_num
112 --           05-Dec-2005  Qiang Li        add four new parameters
113 --           07-Feb-2006  Qiang Li        Change data type of p_fp_tax_reg_num
114 --                                        to Varchar2
115 --===========================================================================
116 FUNCTION Get_Ar_Trx
117 ( p_ar_trx_header_id IN NUMBER
118 , p_org_id           IN NUMBER
119 , p_fp_tax_reg_num   IN VARCHAR2
120 , P_Gt_Inv_Date_From IN DATE
121 , P_Gt_Inv_Date_To   IN DATE
122 , P_Gt_Inv_Num_From  IN VARCHAR2
123 , P_Gt_Inv_Num_To	   IN VARCHAR2
124 )
125 RETURN XMLTYPE;
126 
127 --==========================================================================
128 --  FUNCTION NAME:
129 --
130 --    Get_Gt_Trxs                        Public
131 --
132 --  DESCRIPTION:
133 --
134 --    This function get XML data of Golden Tax transactions
135 --
136 --  PARAMETERS:
137 --      In:  p_org_id                  Operating unit id
138 --           p_ar_trx_header_id        AR transaction header id
139 --           p_Tax_Registration_Number First party tax registration number
140 --           P_Gt_Inv_Date_From        Golden Tax Invoice Date from
141 --           P_Gt_Inv_Date_To          Golden Tax Invoice Date to
142 --           P_Gt_Inv_Num_From         Golden Tax Invoice Number from
143 --           P_Gt_Inv_Num_To	         Golden Tax Invoice Number to
144 --
145 --     Out:
146 --
147 --  Return: XMLTYPE
148 --
149 --
150 --  DESIGN REFERENCES:
151 --      GTA_REPORTS_TD.doc
152 --
153 --  CHANGE HISTORY:
154 --
155 --           05/08/05   	Qiang Li        Created.
156 --           05/12/05     Qiang Li        add five new parameters
157 --
158 --===========================================================================
159   FUNCTION Get_Gt_Trxs
160   ( P_Ar_Trx_Header_Id        IN NUMBER
161   , P_Org_Id                  IN NUMBER
162   , p_Tax_Registration_Number IN VARCHAR2
163   , P_Gt_Inv_Date_From        IN DATE
164   , P_Gt_Inv_Date_To          IN DATE
165   , P_Gt_Inv_Num_From         IN VARCHAR2
166   , P_Gt_Inv_Num_To	          IN VARCHAR2
167   )
168   RETURN Xmltype;
169 
170 
171 --==========================================================================
172 --  PROCEDURE NAME:
173 --
174 --    Generate_Mapping_Rep                Public
175 --
176 --  DESCRIPTION:
177 --
178 --    This procedure generate mapping report data
179 --
180 --  PARAMETERS:
181 --      In:   p_fp_tax_reg_num         First Party Tax Registration Number
182 --            p_org_id                 Operating unit id
183 --            p_trx_source             Transaction source,GT or AR
184 --            p_customer_id            Customer id
185 --            p_gt_inv_num_from        GT invoice number low range
186 --            p_gt_inv_num_to          GT invoice number high range
187 --            p_gt_inv_date_from       GT invoice date low range
188 --            p_gt_inv_date_to         GT invoice date high range
189 --            p_ar_inv_num_from        AR invoice number low range
190 --            p_ar_inv_num_to          AR invoice number high range
191 --            p_ar_inv_date_from       AR invoice date low range
192 --            p_ar_inv_date_to         AR invoice date high range
193 --     Out:
194 --
195 --
196 --
197 --  DESIGN REFERENCES:
198 --      GTA_REPORTS_TD.doc
199 --
200 --  CHANGE HISTORY:
201 --
202 --           05/08/05   	Qiang Li        Created.
203 --           27-Sep-2005:Qiang Li   Add a new parameter fp_tax_reg_number.
204 --
205 --===========================================================================
206 Procedure Generate_Mapping_Rep
207 ( p_org_id	          IN	NUMBER
208 , p_fp_tax_reg_num        IN  VARCHAR2
209 , p_trx_source            IN	NUMBER
210 , p_customer_id           IN	NUMBER
211 , p_gt_inv_num_from       IN	VARCHAR2
212 , p_gt_inv_num_to         IN	VARCHAR2
213 , p_gt_inv_date_from      IN	DATE
214 , p_gt_inv_date_to        IN	DATE
215 , p_ar_inv_num_from       IN	VARCHAR2
216 , p_ar_inv_num_to         IN	VARCHAR2
217 , p_ar_inv_date_from      IN	DATE
218 , p_ar_inv_date_to        IN	DATE
219 );
220 
221 --==========================================================================
222 --  PROCEDURE NAME:
223 --
224 --      Compare_Header                Public
225 --
226 --  DESCRIPTION:
227 --
228 --   This Procedure Compare Ar, Gta, Gt Headers AND Input Difference Record
229 --   Compared Columns Include: "Amount", "Tax Amount", "Customer Name",
230 --  "Bank Name Account" and "Tax Payer Id"
231 --
232 --  PARAMETERS:
233 --      In:   p_org_id                 Operating unit id
234 --            p_ar_header_id           AR Transaction id
235 --
236 --     Out:   x_has_difference
237 --
238 --
239 --  DESIGN REFERENCES:
240 --      GTA_REPORTS_TD.doc
241 --
242 --  CHANGE HISTORY:
243 --
244 --           05/17/05   	Donghai  Wang        Created.
245 --
246 --===========================================================================
247 PROCEDURE Compare_Header
248 ( p_org_id               IN         NUMBER
249 , p_ar_header_id	 IN	    NUMBER
250 , x_has_difference	 OUT NOCOPY BOOLEAN
251 );
252 
253 --==========================================================================
254 --  PROCEDURE NAME:
255 --
256 --      Compare_Lines                Public
257 --
258 --  DESCRIPTION:
259 --
260 --      This Procedure Compare Ar, Gta, Gt Lines And Input Difference Record
261 --      Compared Columns Include: "Goods Description", "Line Amount",
262 --      "Vat Line Tax", "Vat Tax Rate", "Quantity", "Unit Price" And "Uom"
263 --
264 --  PARAMETERS:
265 --      In:   p_org_id                 Operating unit id
266 --            p_ar_header_id           AR Transaction id
267 --
268 --     Out:   x_has_difference
269 --
270 --
271 --  DESIGN REFERENCES:
272 --      GTA_REPORTS_TD.doc
273 --
274 --  CHANGE HISTORY:
275 --
276 --           05/17/05   	Donghai  Wang        Created.
277 --
278 --===========================================================================
279 PROCEDURE Compare_Lines
280 ( p_org_id	         IN          NUMBER
281 , p_ar_header_id	 IN          NUMBER
282 , x_validated_lines      OUT  NOCOPY NUMBER
283 , x_ar_matching_lines    OUT  NOCOPY NUMBER
284 , x_ar_partially_import  OUT  NOCOPY NUMBER
285 , x_has_difference	 OUT  NOCOPY BOOLEAN
286 );
287 
288 --==========================================================================
289 --  PROCEDURE NAME:
290 --
291 --      Get_Unmatched_Lines                Public
292 --
293 --  DESCRIPTION:
294 --
295 --      This Procedure Get Gta, Gt Unmatched Lines And Input Difference Record
296 --
297 --
298 --  PARAMETERS:
299 --      In:   p_org_id                 Operating unit id
300 --            p_ar_header_id           AR Transaction id
301 --
302 --     Out:   x_has_difference
303 --
304 --
305 --  DESIGN REFERENCES:
306 --      GTA_REPORTS_TD.doc
307 --
308 --  CHANGE HISTORY:
309 --
310 --           05/17/05   	Donghai  Wang        Created.
311 --
312 --==========================================================================
313 PROCEDURE Get_Unmatched_Lines
314 ( p_org_id	        IN	   NUMBER
315 , p_ar_header_id	IN	   NUMBER
316 , x_has_difference	OUT NOCOPY BOOLEAN
317 );
318 
319 
320 --==========================================================================
321 --  PROCEDURE NAME:
322 --
323 --      Generate_Discrepancy_Xml               Public
324 --
325 --  DESCRIPTION:
326 --
327 --       This Procedure is used to generate XML element content
328 --       for disrcepancy report output
329 --
330 --
331 --  PARAMETERS:
332 --     In:  p_org_id                     Operating unit id
333 --          p_gta_batch_num_from         GTA batch number low range
334 --          p_gta_batch_num_to           GTA batch number high range
335 --          p_ar_transaction_type        AR transaction type
336 --          p_cust_num_from              Customer Number low range
337 --          p_cust_num_to                Customer Number high range
341 --          p_gl_date_from               GL period date low range
338 --          p_cust_name_from             Customer Name low range
339 --          p_cust_name_to               Customer Name high range
340 --          p_gl_period                  GL period name
342 --          p_gl_date_to                 GL period date high range
343 --          p_ar_trx_batch_from          AR Transaction name low range
344 --          p_ar_trx_batch_to            AR Transaction name high range
345 --          p_ar_trx_num_from            AR Transaction number low range
346 --          p_ar_trx_num_to              AR Transaction number high range
347 --          p_ar_trx_date_from           AR Transaction date low range
348 --          p_ar_trx_date_to             AR Transaction date high range
349 --          p_ar_doc_num_from            AR transaction document
350 --                                       sequence low range
351 --          p_ar_doc_num_to              AR transaction document sequence high range
352 --          p_original_curr_code         Currency code on AR transaction
353 --          p_primary_sales              Primary salesperson
354 --          p_validated_lines_total      the number of ar lines that have been
355 --                                       validated by the report
356 --          p_ar_matching_lines_total    the number of ar lines that exactly
357 --                                       match with GTA invoice
358 --                                       and GT invoice
359 --          p_ar_partially_import_total  ar lines are not fully imported to GT
360 --
361 --    Out:  x_output
362 --
363 --  DESIGN REFERENCES:
364 --      GTA_REPORTS_TD.doc
365 --
366 --  CHANGE HISTORY:
367 --
368 --           05/17/05   	Donghai  Wang        Created.
369 --
370 --==========================================================================
371 PROCEDURE Generate_Discrepancy_Xml
372 ( p_org_id	                  IN	NUMBER
373 , p_gta_batch_num_from	          IN	VARCHAR2
374 , p_gta_batch_num_to              IN	VARCHAR2
375 , p_ar_transaction_type	          IN	NUMBER
376 , p_cust_num_from	          IN	VARCHAR2
377 , p_cust_num_to	                  IN	VARCHAR2
378 , p_cust_name_id	          IN	NUMBER
379 , p_gl_period	                  IN	VARCHAR2
380 , p_gl_date_from	          IN	DATE
381 , p_gl_date_to	                  IN	DATE
382 , p_ar_trx_batch_from	          IN	VARCHAR2
383 , p_ar_trx_batch_to	          IN	VARCHAR2
384 , P_ar_trx_num_from	          IN	VARCHAR2
385 , p_ar_trx_num_to	          IN	VARCHAR2
386 , p_ar_trx_date_from	          IN	DATE
387 , p_ar_trx_date_to	          IN	DATE
388 , p_ar_doc_num_from	          IN	VARCHAR2
389 , p_ar_doc_num_to	          IN	VARCHAR2
390 , p_original_curr_code	          IN	VARCHAR2
391 , p_primary_sales	          IN	NUMBER
392 , p_validated_lines_total         IN    NUMBER
393 , p_ar_matching_lines_total       IN    NUMBER
394 , p_ar_partially_import_total     IN    NUMBER
395 , x_output                        OUT   NOCOPY XMLTYPE
396 );
397 
398 
399 --==========================================================================
400 --  PROCEDURE NAME:
401 --
402 --      Generate_Discrepancy_Rep               Public
403 --
404 --  DESCRIPTION:
405 --
406 --       This Procedure Generate Discrepancy Report Data
407 --
408 --
409 --  PARAMETERS:
410 --      In:  p_org_id                 Operating unit id
411 --           p_gta_batch_num_from     GTA batch number low range
412 --           p_gta_batch_num_to       GTA batch number high range
413 --           p_ar_transaction_type    AR transaction type
414 --           p_cust_num_from          Customer Number low range
415 --           p_cust_num_to            Customer Number high range
416 --           p_cust_name_from         Customer Name low range
417 --           p_cust_name_to           Customer Name high range
418 --           p_gl_period              GL period name
419 --           p_gl_date_from           GL period date low range
420 --           p_gl_date_to             GL period date high range
421 --           p_ar_trx_batch_from      AR Transaction name low range
422 --           p_ar_trx_batch_to        AR Transaction name high range
423 --           p_ar_trx_num_from        AR Transaction number low range
424 --           p_ar_trx_num_to          AR Transaction number high range
425 --           p_ar_trx_date_from       AR Transaction date low range
426 --           p_ar_trx_date_to         AR Transaction date high range
427 --           p_ar_doc_num_from        AR transaction document sequence low range
428 --           p_ar_doc_num_to          AR transaction document sequence high range
429 --           p_original_curr_code     Currency code on AR transaction
430 --           p_primary_sales          Primary salesperson
431 --
432 --    Out:
433 --
434 --  DESIGN REFERENCES:
435 --      GTA_REPORTS_TD.doc
436 --
437 --  CHANGE HISTORY:
438 --
439 --           05/17/05   	Donghai  Wang        Created.
440 --
441 --==========================================================================
442 PROCEDURE Generate_Discrepancy_Rep
443 ( p_org_id	                  IN	NUMBER
444 , p_gta_batch_num_from	          IN	VARCHAR2
448 , p_cust_num_to	                  IN	VARCHAR2
445 , p_gta_batch_num_to              IN	VARCHAR2
446 , p_ar_transaction_type	          IN	NUMBER
447 , p_cust_num_from	          IN	VARCHAR2
449 , p_cust_name_id	          IN	NUMBER
450 , p_gl_period	                  IN	VARCHAR2
451 , p_gl_date_from	          IN	VARCHAR2
452 , p_gl_date_to	                  IN	VARCHAR2
453 , p_ar_trx_batch_from	          IN	VARCHAR2
454 , p_ar_trx_batch_to	          IN	VARCHAR2
455 , P_ar_trx_num_from	          IN	VARCHAR2
456 , p_ar_trx_num_to	          IN	VARCHAR2
457 , p_ar_trx_date_from	          IN	VARCHAR2
458 , p_ar_trx_date_to	          IN	VARCHAR2
459 , p_ar_doc_num_from	          IN	VARCHAR2
460 , p_ar_doc_num_to	          IN	VARCHAR2
461 , p_original_curr_code	          IN	VARCHAR2
462 , p_primary_sales	          IN	NUMBER
463 );
464 
465 --==========================================================================
466 --  PROCEDURE NAME:
467 --
468 --      Generate_Consol_Mapping_Rep               Public
469 --
470 --  DESCRIPTION:
471 --
472 --       This procedure generates Invoice Consolidation Mapping Report data.
473 --
474 --
475 --  PARAMETERS:
476 --      In:  p_org_id                 Operating unit id
477 --           p_gl_period              GL period
478 --           p_customer_num_from      Customer number low range
479 --           p_customer_num_to        Customer number high range
480 --           p_customer_name_from     Customer name low range
481 --           p_customer_name_to       Customer name high range
482 --           p_consol_trx_num_from    Consolidated invoice number low range
483 --           p_consol_trx_num_to      Consolidated invoice number high range
484 --           p_invoice_type           Invoice type
485 --
486 --    Out:
487 --
488 --  DESIGN REFERENCES:
489 --      GTA_12.1.2_Technical_Design.doc
490 --
491 --  CHANGE HISTORY:
492 --
493 --      25-Jul-2009  	Allen Yang        Created.
494 --
495 --==========================================================================
496 Procedure Generate_Consol_Mapping_Rep
497 ( p_org_Id	            IN   NUMBER
498 , p_gl_period           IN   VARCHAR2
499 , p_customer_num_from   IN   VARCHAR2
500 , p_customer_num_to     IN   VARCHAR2
501 , p_customer_name_from  IN   VARCHAR2
502 , p_customer_name_to    IN   VARCHAR2
503 , p_consol_trx_num_from IN   VARCHAR2
504 , p_consol_trx_num_to   IN   VARCHAR2
505 , p_invoice_type        IN   VARCHAR2
506 );
507 
508 --==========================================================================
509 --  PROCEDURE NAME:
510 --
511 --      Get_Consolidation_Trx               Public
512 --
513 --  DESCRIPTION:
514 --
515 --       This procedure returns XML data for a given consolidated invoice.
516 --
517 --
518 --  PARAMETERS:
519 --      In:  p_trx_header_id          invoice header identifier
520 --
521 --
522 --      Out:
523 --
524 --  DESIGN REFERENCES:
525 --      GTA_12.1.2_Technical_Design.doc
526 --
527 --  CHANGE HISTORY:
528 --
529 --      25-Jul-2009  	Allen Yang        Created.
530 --
531 --==========================================================================
532 FUNCTION Get_Consolidation_Trx(p_trx_header_id	  IN  NUMBER)
533 RETURN XMLTYPE;
534 
535 --==========================================================================
536 --  PROCEDURE NAME:
537 --
538 --      Get_Consolidated_Trxs               Public
539 --
540 --  DESCRIPTION:
541 --
542 --      For a given consolidated invoice, get xml data of its
543 --      consolidation invoices.
544 --
545 --
546 --  PARAMETERS:
547 --      In:  p_trx_header_id          invoice header identifier
548 --
549 --
550 --      Out:
551 --
552 --  DESIGN REFERENCES:
553 --      GTA_12.1.2_Technical_Design.doc
554 --
555 --  CHANGE HISTORY:
556 --
557 --      25-Jul-2009  	Allen Yang        Created.
558 --
559 --==========================================================================
560 FUNCTION Get_Consolidated_Trxs(p_trx_header_id	  IN  NUMBER)
561 RETURN XMLTYPE;
562 --==========================================================================
563 --  PROCEDURE NAME:
564 --
565 --      Compare_Consolidated_Inv                Public
566 --
567 --  DESCRIPTION:
568 --
569 --   This Procedure Compare completed consolidated_invs with gt invoice
570 --
571 --  PARAMETERS:
572 --      In:   p_org_id                 Operating unit id
573 --            p_gta_header_id          GTA invoice header id
574 --
575 --     Out:   x_has_difference
576 --
577 --
578 --  DESIGN REFERENCES:
579 --
580 --
581 --  CHANGE HISTORY:
582 --
583 --           09-Aug-2009  Yao Zhang   Created.
584 --===========================================================================
585 PROCEDURE Compare_Consolidated_Inv
586 (p_org_id         NUMBER
587 ,p_gta_header_id  NUMBER
588 ,x_has_difference OUT NOCOPY	BOOLEAN
589 ) ;
590 END AR_GTA_REPORTS_PKG;